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Preface 



The material in this guide is organized into two major parts: an overview of the 
RISC/os (UMIPS) operating system and a set of tutorials on the main tools available 
on the system. A brief description of each part follows. The last section of this Pre- 
face, "Notation Conventions," describes the typographical notation with which all the 
chapters of this Guide conform. You may want to refer back to this section from 
time to time as you read the Guide. 

Throughout this publication, the RISC/os (UMIPS) operating system is referred to as 
UMIPS or simply "the operating system". 



System Overview 

This part consists of Chapters 1-3, which introduce you to the basic principles of the 
UMIPS operating system. Each chapter builds on information presented in preceding 
chapters, so it is important to read them in sequence. 

■ Chapter 1, "What is the UMIPS System?", provides an overview of the operat- 
ing system. 

■ Chapter 2, "Basics for UMIPS System Users," discusses the general rules and 
guidelines for using the UMIPS system. It covers topics related to using your 
terminal, obtaining a system account, and establishing contact with the UMIPS 
system. 

■ Chapter 3, "Using the File System," offers a working perspective of Jhe file sys- 
tem. It introduces commands for building your own directory structure, 
accessing and manipulating the subdirectories and files you organize within it, 
and examining the contents of other directories in the system for which you 
have access permission. 



UMIPS System Tutorials 

The second part of the Guide consists of tutorials on the following topics: the ed text 
editor, the vi text editor, the shell command language and programming language, and 
electronic communication tools. For a thorough understanding of the material, we 
recommend that you work through the examples and exercises as you read each 
tutorial. The tutorials assume you understand the concepts introduced in 
Chapters 1-3. 

■ Chapter 4, "Overview of the Tutorials," introduces the four chapters of tutori- 
als in the second half of the Guide. It highlights UMIPS system capabilities 
such as command execution, text editing, electronic communication, program- 
ming, and aids to software development. 

■ Chapter 5, "Line Editor Tutorial (ed)," teaches you to how to use the ed text 
editor to create and modify text on a video display terminal or paper printing 
terminal. 

■ Chapter 6, "Screen Editor Tutorial (vi)," teaches you how to use the visual text 
editor, vi, to create and modify text on a video display terminal. 
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vi, the visual editor, is based on software developed by The University of California, 
note Berkeley, California; Computer Science Division, Department of Electrical Engineer- 

ing and Computer Science, and such software is owned and licensed by the Regents 
~ I of the University of California. 



« Chapter 7, "Shell Tutorial," teaches you to how to use the shell, both as a com- 
mand interpreter and as a programming language used to create shell pro- 
grams. 

■ Chapter 8, "Communication Tutorial," teaches you how to exchange messages 
and files among users of UMIPS systems and other UNIX-based systems. 

■ Chapter 9, "C Shell Introduction," introduces csh, a command language inter- 
preter for UMIPS systems. 



Reference Information 

Six appendices and a glossary of UMIPS system terms are also provided for refer- 
ence. 

■ Appendix A, "Summary of the File System," illustrates how information is 
stored in the UMIPS operating system. 

■ Appendix B, "Summary of UMIPS System Commands," describes, in alphabet- 
ical order, each UMIPS system command discussed in the Guide. 

P Appendix C, "Quick Reference to ed Commands," is a quick reference for the 
line editor, ed. (For details, see Chapter 5, "Line Editor Tutorial. ") The com- 
mands are organized by topic, as they are covered in Chapter 5. 

■ Appendix D, "Quick Reference to vi Commands," is a reference for the full 
screen editor, vi, discussed in Chapter 6, "Screen Editor Tutorial (vi)." Com- 
mands are organized by topic, as covered in Chapter 6. 

■ Appendix E, "Summary of Shell Command Language," is a summary of the 
shell command language, notation, and programming constructs, as discussed 
in Chapter 7, "Shell Tutorial." 

■ Appendix F, "Setting Up the Terminal," explains how to configure your termi- 
nal for use with the UMIPS system, and create multiple windows on the 
screens of terminals with windowing capability. 

■ The Glossary defines terms pertaining to the UMIPS system used in this book. 
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Notation Conventions 



The following notation conventions are used throughout this Guide. 
bold 



italic 



constant width 



<> 



<*char> 



[] 



User input, such as commands, options and arguments to 
commands, variables, and the names of directories and 
files, appear in bold. 

Names of variables to which values must be assigned (such 
as password) appear in italic. 

UMIPS system output, such as prompt signs and 
responses to commands, appear in constant width. 

Input that does not appear on the screen when typed, such 
as passwords, tabs, or RETURN, appear between angle 
brackets. 

Control characters are shown between angle brackets 
because they do not appear on the screen when typed. 
The circumflex (") represents the control key (usually 
labeled CTRL). To type a control character, hold down 
the control key while you type the character specified by 
char. For example, the notation <*d> means to hold 
down the control key while pressing the D key; the letter 
D will not appear on the screen. 

Command options and arguments that are optional, such 
as [-msCj] , are enclosed in square brackets. 

The vertical bar separates optional arguments from which 
you may choose one. For example, when a command 
line has the following format: 



command [argl | arg2] 



You may use either argl or argl when you issue the com- 
mand. 

Ellipses after an argument mean that more than one argu- 
ment may be used on a single command line. 

Arrows on the screen (shown in examples in Chapter 6) 
represent the cursor. 

command(number) A command name followed by a number in parentheses 
refers to the part of a UMIPS system reference manual 
that documents that command. (There are three reference 
manuals: the User's Reference Manual, Programmer's 
Reference Manual, and System Administrator's Reference 
Manual.) For example, the notation cat(l) refers to the 
page in section 1 (of the User's Reference Manual) that 
documents the cat command. 



In sample commands the $ sign is used as the shell command prompt. This is not 
true for all systems. Whichever symbol your system uses, keep in mirid that prompts 
are produced by the system; although a prompt is sometimes shown at the beginning 
of a command line as it would appear on your screen, you are not meant to type it. 
(The $ sign is also used to reference the value of positional parameters and named 
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variables; see Chapter 7 for details.) 

In all chapters, full and partial screens are used to display examples of how your ter- 
minal screen will look whew you interact with the UMIPS system. These examples 
show how to use the UMIPS system editors, write short programs, and execute com- 
mands. The input (characters typed by you) and output (characters printed by the 
UMIPS system) are shown in these screens in accordance with the conventions listed 
above. AH examples apply regardless of the type of terminal you use. 

The commands discussed in each section of a chapter are reviewed at the end of that 
section, A summary of vi commands is found in Appendix D, where they are listed 
by topic. At the end of some sections, exercises are also provided so you can experi- 
ment with the commands. The answers to all the exercises in a chapter are at the end 
of that chapter. 



NOTE 



The text in the User's Guide was prepared with the UMIPS system text editors 
described in the Guide and formatted with the DOCUMENTER'S WORKBENCH 
Software: troff, tbl, pic, and mm macros. 
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What the UMIPS System Does 



The UMIPS operating system is a set of programs (or software) that controls the com- 
puter, acts as the link between you and the computer, and provides tools to help you 
do your work. It is designed to provide an uncomplicated, efficient, and flexible com- 
puting environment. Specifically, the UMIPS system offers the following advantages: 

■ a general purpose system for performing a wide variety of jobs or applications 

■ an interactive environment that allows you to communicate directly with the 
computer and receive immediate responses to your requests and messages 

■ a multi-user environment that allows you to share the computer's resources 
with other users without sacrificing productivity 



This technique is called timesharing. The UMIPS system interacts with users 
on a rotating basis, so that it appears to be interacting with all users simultane- 
ously. 

■ a multi-tasking environment that enables you to execute more than one pro- 
gram simultaneously. 

The organization of the UMIPS system is based on four major components: 

the kernel The kernel is a program that constitutes the nucleus of the 

operating system; it coordinates the functioning of the 
computer's internals (such as allocating system resources). 
The kernel works invisibly; you need never be aware of it 
while doing your work. 

the file system The file system provides a method of handling data that makes 
it easy to store and access information. 

the shell The shell is a program that serves as the command interpreter. 

It acts as a liaison between you and the kernel, interpreting 
and executing your commands. Because it reads input from 
you and sends you messages, it is described as interactive. 

commands Commands are the names of programs that you request the 

computer to execute. Packages of programs are called tools. 
The UMIPS system provides tools for jobs such as creating 
and changing text, writing programs and developing software 
tools, and exchanging information with others via the com- 
puter. 
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How the UMIPS System Works 



Figure 1-1 is a model of the UMIPS system. Each circle represents one of the main 
components of the UMIPS system: the kernel, the shell, and user programs or com- 
mands. The arrows suggest the shell's role as the medium through which you and the 
kernel communicate. The remainder of this chapter describes each of these com- 
ponents, along with another important feature of the UMIPS system, the file system. 




Figure 1-1: Model of the UMIPS System 



The Kernel 

The nucleus of the UMIPS system is called the kernel. The kernel controls access to 
the computer, manages the computer's memory, maintains the file system, and allo- 
cates the computer's resources among users. Figure 1-2 is a functional view of the 
kernel. 
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Figure 1-2: Functional View of the Kernel 



The File System 

The file system is the cornerstone of the UMIPS operating system. It provides a logi- 
cal method of organizing, retrieving, and managing information. The structure of the 
file system is hierarchical; if you could see it, it might look like an organization chart 
or an inverted tree (Figure 1-3). 
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Figure 1-3: The Hierarchical Structure of the File System 



The file is the basic unit of the UMIPS system and it can be any one of three types: 
an ordinary file, a directory, or a special file. (See Chapter 3, "Using the File Sys- 
tem.") 

Ordinary Files 

An ordinary file is a collection of characters that is treated as a unit by the system. 
Ordinary files are used to store any information you want to save. They may contain 
text for letters or reports, code for the programs you write, or commands to run your 
programs. Once you have created a file, you can add material to it, delete material 
from it, or remove it entirely when it is no longer needed. 

Directories 

A directory is a super-file that contains a group of related files. For example, a direc- 
tory called sales may hold files containing monthly sales figures called jan, feb, mar, 
and so on. You can create directories, add or remove files from them, or remove 
directories themselves at any time. 

All the directories that you create and own will be located in your home directory. 
This is a directory assigned to you by the system when you receive a recognized login. 
You have control over this directory; no one else can read or write files in it without 
your explicit permission, and you determine its structure. 

The UMIPS system also maintains several directories for its own use. The structure 
of these directories is much the same on all UMIPS systems. These directories, 
which include /imix (the kernel) and several important system directories, are located 
directly under the root directory in the file hierarchy. The root directory (designated 
by /) is the source of the UMIPS file structure; all directories and files are arranged 
hierarchically under it. 

Special Files 

Special files constitute the most unusual feature of the file system. A special file 
represents a physical device such as a terminal, disk drive, magnetic tape drive, or 
communication link. The system reads and writes to special files in the same way it 
does to ordinary files. However the system's read and write requests do not activate 
the normal file access mechanism; instead, they activate the device handler associated 
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with the file. 

Some operating systems require you to define the type of file you have and to use it in 
a specified way. In those cases, you must consider how the files are stored since they 
might be sequential, random-access, or binary files. To the UMIPS system, however, 
all files are alike. This makes the UMIPS system file structure easy to use. For 
example, you need not specify memory requirements for your files since the system 
automatically does this for you. Or if you or a program you write needs to access a 
certain device, such as a printer, you specify the device just as you would another one 
of your files. In the UMIPS system, there is only one interface for all input from you 
and output to you; this simplifies your interaction with the system. 

Figure 1-4 shows an example of a typical file system. Notice that the root directory 
contains the kernel (/unix) and several important system directories. 




= Directories 
{ | = Ordinary Files 
\/ = Special Files 



Figure 1-4: Example of a File System 



/bin contains many executable programs and utilities 

/dev contains special files that represent peripheral devices such as the con- 
sole, the line printer, user terminals, and disks 

/etc contains programs and data files for system administration 

/lib contains libraries for programs and languages 

/tmp contains temporary files that can be created by any user 

/usr contains other directories including mail, which contains files for stor- 
ing electronic mail, and news, which contains files for storing elec- 
tronic news articles. 
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In summary, the directories and files you create comprise the portion of the file sys- 
tem that is controlled by you. Other parts of the file system are provided and main- 
tained by the operating system, such as /bin, /dev, /etc, /lib, /tmp and /usr, and 
have much the same structure on all UMIPS systems. 

You will learn more about the file system in other chapters. Chapter 3 shows how to 
organize a file system directory structure, and access and manipulate files. Chapter 4 
gives an overview of UMIPS system capabilities. The effective use of these capabili- 
ties depends on your familiarity with the file system and your ability to access infor- 
mation stored within it. Chapters 5 and 6 are tutorials designed to teach you how to 
create and edit files. 



The Shell 

The shell is a unique command interpreter that allows you to communicate with the 
operating system. The shell reads the commands you enter and interprets them as 
requests to execute other programs, access files, or provide output. The shell is also 
a powerful programming language, not unlike the C programming language, that pro- 
vides conditional execution and control flow features. The model of a UMIPS system 
in Figure 1-1 shows the two-way flow of communication between you and the com- 
puter via the shell. 

Chapter 4 describes the shell's capabilities. Chapter 7 is a tutorial that teaches you to 
write simple shell programs called shell scripts and custom tailor your environment. 



Commands 

A program is a set of instructions to the computer. Programs that can be executed by 
the computer without need for translation are called executable programs or com- 
mands. As a typical user of the UMIPS system, you have many standard programs 
and tools available to you. If you use the UMIPS system to write programs and 
develop software, you can also draw on system calls, subroutines, and other tools. Of 
course, any programs you write yourself will be at your disposal, too. 

This book introduces you to many of the UMIPS system programs and tools that you 
will use on a regular basis. If you need additional information on these or other stan- 
dard programs, refer to the User's Reference Manual. For information on tools and 
routines related to programming and software development, consult the Programmer's 
Reference Manual. 

The reference manuals may also be available online. (Online documents are stored in 
your computer's file system.) You can summon pages from the online manuals by 
executing the command man (short for manual page). For details on how to use the 
man command refer to the man(l) page in the User's Reference Manual. 

What Commands Do 

The outer circle of the UMIPS system model in Figure 1-1 organizes the system pro- 
grams and tools into functional categories. These functions include: 

text processing The system provides programs such as line and 

screen editors for creating and changing text, a 
spelling checker for locating spelling errors, and 
optional text formatters for producing high-quality 
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paper copies that are suitable for publication. 



information management 



The system provides many programs that allow you 
to create, organize, and remove files and direc- 
tories. 



electronic communication Several programs, such as mail, enable you to 

transmit information to other users and to other 
UMIPS systems. 



How to Execute Commands 

To make your requests comprehensible to the UMIPS system, you must present each 
command in the correct format, or command line syntax. This syntax defines the 
order in which you enter the components of a command line. Just as you must put 
the subject of a sentence before the verb in an English sentence, so must you put the 
parts of a command line in the order required by the command line syntax. Other- 
wise, the UMIPS system shell will not be able to interpret your request. Here is an 
example of the syntax of a UMIPS system command line. 

command option(s) argument (s)<CR> 

On every UMIPS system command line you must type at least two components: a 
command name and the RETURN key. (The notation <CR> is used as an instruc- 
tion to press the RETURN key throughout this Guide.) A command line may also 
contain either options or arguments, or both. What are commands, options, and 
arguments? 

■ a command is the name of the program you want to run 

■ an option modifies how the command runs 

■ an argument specifies data on which the command is to operate (usually the 
name of a directory or file) 

In command lines that include options and/or arguments, the component words are 
separated by at least one blank space. (You can insert a blank by pressing the space 
bar.) If an argument name contains a blank, enclose that name in double quotation 
marks. For example, if the argument to your command is sample 1, you must type it 
as follows: "sample 1". If you forget the double quotation marks, the shell will inter- 
pret sample and 1 as two separate arguments . 

Some commands allow you to specify multiple options and/or arguments on a com- 
mand line. Consider the following command line: 



software development 



Several UMIPS system programs establish a 
friendly programming environment by providing 
UMIPS-to-programming-language interfaces and by 
supplying numerous utility programs. 



additional utilities 



The system also offers capabilities for generating 
graphics and performing calculations. 
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command 




arguments 



f — — ^ 

wc -1 -w file! file2 fileS 



In this example, wc is the name of the command and two options, —I and -w, have 
been specified. (The UMIPS system usually allows you to group options such as these 
to read —Iw if you prefer.) In addition, three files (ftlel, file2, and fileS) are specified 
as arguments. Although most options can be grouped together, arguments cannot. 

The following examples show the proper sequence and spacing in command line syn- 
tax: 



Incorrect 



Correct 



wcflle 

wc-lfile 

wc -1 w file 



wc filelfilel 



wc file 
wc -1 file 
wc — Iw file 
or 

wc —I — w file 
wc filel file! 



Remember, regardless of the number of components, you must end every command 
line by pressing the RETURN key. 

How Commands Are Executed 

Figure 1-5 shows the flow of control when the UMIPS system executes a command. 



YOUR 
REQUEST 



fa 



OUTPUT 



SHELL 

(COMMAND 
LANGUAGE 
INTERPRETER) 



DIRECTORY 
SEARCH 



PROGRAM 
EXECUTION 



PROGRAM 
RETRIEVAL 




EXECUTABLE 
PROGRAMS, 



Figure 1-5: Execution of a UMIPS System Command 
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To execute a command, enter a command line when a prompt (such as a $ sign) 
appears on your screen. The shell considers your command as input, searches 
through one or more directories to retrieve the program you specified, and conveys 
your request, along with the program requested, to the kernel. The kernel then fol- 
lows the instructions in the program and executes the command you requested. After 
the program has finished running, the shell signals that it is ready for your next com- 
mand by printing another prompt. 

This chapter has described some basic principles of the UMIPS operating system. 
The following chapters will help you apply these principles according to your comput- 
ing needs. 
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Getting Started 



This chapter acquaints you with the general rules and guidelines for working on the 
UMIPS system. Specifically, it lists the required terminal settings, and explains how 
to use the keyboard, obtain a login, log on and off the system, and enter simple com- 
mands. 

To establish contact with the UMIPS system, you need: 

■ a terminal 

■ a login name (a name by which the UMIPS system identifies you as one of its 
authorized users) 

■ a password that verifies your identity 

■ instructions for dialing in and accessing the UMIPS system if your terminal is 
not directly connected or hard-wired to the computer 

This chapter follows the notation conventions used throughout this Guide. For a 
description of them, see the Preface. 



BASICS FOR UMIPS SYSTEM USERS 2-1 



The Terminal 



A terminal is an input/output device: you use it to enter requests to the UMIPS sys- 
tem, and the system uses it to send its responses to you. There are two basic types of 
terminals: video display terminals and printing terminals (see Figure 2-1). 



Figure 2-1: A Video Display Terminal and a Printing Terminal 



The video display terminal shows input and output on a display screen; the printing 
terminal, on continuously fed paper. In most respects, this difference has no effect 
on the user's actions or the system's responses. Instructions throughout this book 
that refer to the terminal screen apply in the same way to the paper in a printing ter- 
minal, unless noted otherwise. 



Regardless of the type of terminal you use, you must configure it properly to commun- 
icate with the UMIPS system. If you have not set terminal options before, you might 
feel more comfortable seeking help from someone who has. 

How you configure a terminal depends on the type of terminal you are using. Some 
terminals are configured with switches; others are configured directly from the key- 
board by using a set of function keys. To determine how to configure your terminal, 
consult the owner's manual provided by the manufacturer. 

The following is a list of configuration checks you should perform on any terminal 
before trying to log in on the UMIPS system. 

1. Turn on the power. 

2. Set the terminal to ON-LINE or REMOTE operation. This setting ensures 
the terminal is under the direct control of the computer. 

3. Set the terminal to FULL DUPLEX mode. This mode ensures two-way com- 
munication (input/output) between you and the UMIPS system. 
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The Terminal 



4 . If your terminal is not directly connected or hard-wired to the computer, 
make sure the acoustic coupler or data phone set you are using is set to the 
FULL DUPLEX mode. 

5. Set character generation to LOWER CASE. If your terminal generates only 
upper case letters, the UMIPS system will accommodate it by printing every- 
thing in upper case letters. 

6. Set the terminal to NO PARITY. 

7. Set the baud rate. This is the speed at which the computer communicates 
with the terminal, measured in characters per second. (For example, a termi- 
nal set at a baud rate of 4800 sends and receives 480 characters per second.) 
Depending on the computer and the terminal, baud rates between 300 and 
38400 are available. Some computers may be capable of processing charac- 
ters at higher speeds. 



Keyboard Characteristics 

There is no standard layout for terminal keyboards. However, all terminal keyboards 
share a standard set of 128 characters called the ASCII character set. (ASCII is an 
acronym for American Standard Code for Information Interchange.) While the keys 
are labeled with characters that are meaningful to you (such as the letters of the 
alphabet), each one is also associated with an ASCII code that is meaningful to the 
computer. 

The keyboard layout on a typical ASCII terminal is basically the same as a 
typewriter's, with a few additional keys for functions such as interrupting tasks. Fig- 
ure 2-2 shows an example of a keyboard on an ASCII terminal. 
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Figure 2-2: Keyboard Layout of a Teletype 5410 Terminal 



The keys correspond to the following: 

■ the letters of the English alphabet (both upper case and lower case) 

■ the numerals (0 through 9) 

m a variety of symbols (including ! @ # $ % A & ( ) _ - + = ~ 6 { } [ ] \ : ; '" ? < 
> , ? /) 

■ specially defined words (such as RETURN and BREAK), and abbreviations 
(such as DEL for delete, CTRL for control, and ESC for escape) 
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While terminal and typewriter keyboards both have alphanumeric keys, terminal key- 
boards also have keys designed for use with a computer. These keys are labeled with 
characters or symbols that remind the user of their functions. However, their place- 
ment may vary from terminal to terminal because there is no standard keyboard lay- 
out. 



Typing Conventions 

To interact effectively with the UMIPS system, you should be familiar with its typing 
conventions. The UMIPS system requires that you enter commands in lower case 
letters (unless the command includes an upper case letter). Other conventions enable 
you to perform tasks, such as erasing letters or deleting lines, simply by pressing one 
key or entering a specific combination of characters. Characters associated with tasks 
in this way are known as special characters. Figure 2-3 lists the conventions based on 
special characters. Detailed explanations of them are provided on the next few pages. 



Key(s) 


Meaning 


$ 


System's command prompt (your cue to issue a command) 


#* 


Erase a character 


@ 


Erase or kill an entire line 


<BREAK> 


Stop execution of a program or command 


<DEL> 


Delete or kill the current command line 


<ESC> 


When used with another character, performs a specific function 
(called an escape sequence) 

When used in an editing session with the vi editor, ends the text 
input mode and returns you to the command mode 


<CR> 


Press the RETURN key. This ends a line of typing and puts the 
cursor on a new line. 


<Td>t 


Stop input to the system or log off 


<Ti> 


Backspace for terminals without a backspace key 


«Ti> 


Horizontal tab for terminals without a tab key 


<Ts> 


Temporarily stops output from printing on the screen 


<~q> 


Makes the output resume printing on the screen after it has 
been stopped by the <"s> command 



* Nonprinting characters are shown in angle brackets (< >). 

f Characters preceded by a circumflex (") are called control characters and are pro- 
nounced control-letter. To type a control character, hold down the control key and 
press the specified letter. 

Figure 2-3: UMIPS System Typing Conventions 
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The Command Prompt 

The standard UMIPS system command prompt is the dollar sign ($). When the 
prompt appears on your terminal screen, the UMIPS system is waiting for instructions 
from you. The appropriate response to the prompt is to issue a command and press 
the RETURN key. 

The $ sign is the default value for the command prompt. Chapter 7 explains how to 
change it if you would prefer another character or character string as your command 
prompt. 

Correcting Typing Errors 

There are two keys you can use to delete text so that you can correct typing errors. 
The @ (at) sign key kills the current line and the # (pound) sign key erases the last 
character typed. These keys are available by default to perform these functions. 
However, if you want to use other keys, you can reassign the erase and kill functions. 
(For instructions, see "Reassigning the Delete Functions" later in this section and 
"Setting Terminal Options" in Chapter 7.) 

Deleting the Current Line: the @ Sign 

The @ sign key kills the current line. When you press it, an @ sign is added to the 
end of the line, and the cursor moves to the next line. The line containing the error 
is not erased from the screen but is ignored. 

The @ sign key works only on the current line; be sure to press it before you press 
the RETURN key if you want to kill a line. In the following example, a misspelled 
command is typed on a command line; the command is cancelled with the @ sign: 

whooo@ 
who<CR> 

Deleting the Last Characters Typed: the # Sign Key 

The # (pound) sign key deletes the character(s) last typed on the current line. When 
you type a # sign, the cursor backs up over the last character and lets you retype it, 
thus effectively erasing it. This is an easy way to correct a typing error. 

You can delete as many characters as you like as long as you type a corresponding 
number of # signs. For example, in the following command line, two characters are 
deleted by typing two # signs. 

dattw##e<CR> 

The UMIPS system interprets this as the date command, typed correctly. 
The BACKSPACE Key 

Many people prefer to use the BACKSPACE key for the erase function instead of the 
# sign key. When you press the BACKSPACE key, the cursor backs up over your 
errors, erasing them as it goes. It does not print anything, unlike the # sign key, 
which prints a # sign on your screen between an error and a correction. When you 
have finished correcting an error with the BACKSPACE key, the line of text on the 
screen looks as though it was typed perfectly. 

The # sign and BACKSPACE keys are equally effective at deleting characters, but 
using the BACKSPACE key gives you better visual information about what you are 
doing. 
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NOTE 



Some terminals may not recognize the # sign key as a delete character. 



r 

Reassigning the Delete Functions 

As stated earlier, you can change the keys that kill lines and erase characters. If you 
want to change these keys for a single working session, you can issue a command to 
the shell to reassign them; the delete functions will revert to the default keys (# and 
@) as soon as you log off. If you want to use other keys regularly, you must specify 
the reassignment in a file called .profile. Instructions for making both temporary and 
permanent key reassignments, along with a description of the .profile, are given in 
Chapter 7. 

There are three points to keep in mind if you reassign the delete functions to non- 
default keys. First, the UMIPS system allows only one key at a time to perform a 
delete function. When you reassign a function to a non-default key, you also take that 
function away from the default key. For example, if you reassign the erase function 
from the # sign key to the BACKSPACE key, you will no longer be able to use the # 
sign key to erase characters. Neither will you have two keys that perform the same 
function. 

Secondly, such reassignments are inherited by any other UMIPS system program that 
allows you to perform the function you have reassigned. For example, the interactive 
text editor called ed (described in Chapter 5) allows you to delete text with the same 
key you use to correct errors on a shell commarid line (as described in this section). 
Therefore, if you reassign the erase function to the BACKSPACE key, you will have 
to use the BACKSPACE key to erase characters while working in the ed editor, as 
well. The # sign key will no longer work. 

Finally, keep in mind that any reassignments you have specified in your .profile do 
not become effective until after you log in. Therefore, if you make an error while typ- 
ing your login name or password, you must use the # sign key to correct it. 

Whichever keys you use, remember that they work only on the current line. Be sure 
to correct your errors before pressing the RETURN key at the end of a line. 

Using Special Characters as Literal Characters 

What happens if you want to use a special character in with literal meaning as a unit 
of text? Since the UMIPS system's default behavior is to interpret special characters 
as commands, you must tell the system to ignore or escape from a character's special 
meaning whenever you want to use it as a literal character. The backslash (\) enables 
you to do this. Type a \ before any special character that you want to have treated as 
it appears. By doing this you essentially tell the system to ignore this character's spe- 
cial meaning and treat it as a literal unit of text. 

For example, suppose you want to add the following sentence to a file: 

Only one # appears on this sheet of music. 

To prevent the UMIPS system from interpreting the # sign as a request to delete a 
character, enter a \ in front of the # sign. If you do not, the system will erase the 
space after the word one and print your sentence as follows: 

Only one appears on this sheet of music. 

To avoid this, type your sentence as follows: 

Only one \# appears on this sheet of music. 
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Typing Spaed 

After the prompt appears on your terminal screen, you can type as fast as you want, 
even when the UMIPS system is executing a command or responding to one. Since 
your input and the system's output appear on the screen simultaneously, the printout 
on your screen will appear garbled. However, while this may be inconvenient for 
you, it does not interfere with the UMIPS system's work because the UMIPS system 
has read-ahead capability. This capability allows the system to handle input and out- 
put separately. The system takes and stores input (your next request) while it sends 
output (its response to your last request) to the screen. 

Stopping a Command 

If you want to stop the execution of a command, simply press the BREAK or 
DELETE key. The UMIPS system will stop the program and print a prompt on the 
screen. This is its signal that it has stopped the last command from running and is 
ready for your next command. Some users reassign by pressing CTRL-c ( A c) to stop 
execution of commands instead of using DELETE. 

Using Control Characters 

Locate the control key on your terminal keyboard. It may be labeled CONTROL or 
CTRL and is probably to the left of the A key or below the Z key. The control key 
is used in combination with other characters to perform physical controlling actions 
on lines of typing. Commands entered in this way are called control characters. 
Some control characters perform mundane tasks such as backspacing and tabbing. 
Others define commands that are specific to the UMIPS system. For example, one 
control character (control-s) temporarily halts output that is being printed on a termi- 
nal screen. 

To type a control character, hold down the control key and press the appropriate 
alphabetic key. Most control characters do not appear on the screen when typed and 
therefore are shown between angle brackets (see "Notation Conventions" in the Pre- 
face). The control key is represented by a circumflex ( A ) before the letter. Thus, for 
example, <"s> designates the control-s character. 

The two functions for which control characters are most often used are to control the 
printing of output on the screen and to log off the system. To prevent information 
from rolling off the screen on a video display terminal, type <"s>; the printing will 
stop. When you are ready to read more output, type < A q> and the printing will 
resume. 

To log off the UMIPS system, type <Td>. (See "Logging Off" later in this chapter for 
a detailed description of this procedure.) 

In addition, the UMIPS system uses control characters to provide capabilities that 
some terminals fail to make available through function specific keys. If your key- 
board does not have a backspace key, you can use the <"h> key instead. You can 
also set tabs without a tab key by typing <1> if your terminal is set properly. (Refer 
to the section entitled "Possible Problems When Logging In" for information on how 
to set the tab key.) 

Now that you have configured the terminal and inspected the keyboard, one step 
remains before you can establish communication with the UMIPS system: you must 
obtain a login name. 
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Obtaining a Login Name 



A login name is the name by which the UMIPS system verifies that you are an author- 
ized user of the system when you request access to it. It is so called because you 
must enter it every time you want to log in. (The expression logging in is derived 
from the fact that the system maintains a log for each user, in which it records the 
type and amount of system resources being used.) 

To obtain a login name, set up a UMIPS system account through your local system 
administrator. There are few rules governing your choice of a login name. Typically, 
it is three to eight characters long. It can contain any combination of lower case 
alphanumeric characters, as long as it starts with a letter. It cannot contain any sym- 
bols. 

However, your login name will probably be determined by local practices. The users 
of your system may all use their initials, last names, or nicknames as their login 
names. Here are a few examples of legal login names: starship, mary2, and jmrs. 
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tem 



Typically, you will be using either a terminal that is wired directly to a computer or a 
terminal that communicates with a computer over a telephone line. 



NOTE 



This section describes a typical procedure for logging in, but may not apply to your 
system. There are many ways to log in on a UMIPS system over a telephone line. 
Security precautions on your system may require that you use a special telephone 
number or other security code. For instructions on logging in on your UMIPS system 
from outside your computer installation site, see your system administrator. 



Turn on your terminal. If it is directly connected, the login: prompt will immedi- 
ately appear in the upper lefthand corner of the screen. 

If you are going to communicate with the computer over a telephone line, you must 
now establish a connection. The following procedure is an example of a method you 
might use to do this. (For the procedure required by your system, see your system 
administrator.) 

1. Dial the telephone number that connects you to the UMIPS system. You will 
hear one of the following: 

□ A busy signal. This means that either the circuits are busy or the line is 
in use. Hang up and dial again. 

□ Continuous ringing and no answer. This usually means that there is trou- 
ble with the telephone line or that the system is inoperable because of 
mechanical failure or electronic problems. Hang up and dial again later. 

□ A high-pitched tone. This means that the system is accessible. 

2. When you hear the high-pitched tone, place the handset of the phone in the 
acoustic coupler or momentarily press the appropriate button on the data 
phone set (see the owner's manual for the appropriate equipment). Then 
replace the handset in the cradle (see Figure 2-4). 

3. After a few seconds, the login : prompt will appear in the upper lefthand 
corner of the screen. 

4. A series of meaningless characters may appear on your screen. This means 
that the telephone number you called serves more than one baud rate; the 
UMIPS system is trying to communicate with your terminal, but is using the 
wrong speed. Press the BREAK or RETURN key; this signals the system to 
try another speed. If the UMIPS system does not display the login : prompt 
within a few seconds, press the BREAK or RETURN key again. 
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AT&T Data Phone 
Set 212A 





L 



AT&T Acoustic 
Coupler 



AT&T Dataphone II 
Modem 



Figure 2-4: Data Phone Set, Modem, and Acoustic Coupler 



Login Procedure 

When the login : prompt appears, type your login name and press the RETURN 
key. For example, if your login name is starship, your login line will look like this: 

login: starship<CR> 



Remember to type in lower case letters. If you use upper case from the time you log 
in, the UMIPS system will expect and respond in upper case exclusively until the next 
time you log in. It will accept and run many commands typed in upper case, but will 
not allow you to edit files. 



Password 

Next, the system prompts you for your password. Type your password and press the 
RETURN key. For security reasons, the UMIPS system does not print (or echo) 
your password on the screen. 

If both your login name and password are acceptable to the UMIPS system, the sys- 
tem may print the message of the day and/or current news items and then the default 
command prompt ($). (The message of the day might include a schedule for system 
maintenance, and news items might include an announcement of a new system tool.) 
When you have logged in, your screen will look similar to this: 
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CWlogin: starship<CR> 

password: 

UMIPS system news 
$ 

If you make a typing mistake when logging in, the UMIPS system prints the message 
login incorrect on your screen. Then it gives you a second chance to log in by 
printing another login : prompt. 

login: ttarship<CR> 

password: 
login incorrect 
login: 

The login procedure may also fail if the communication link between your terminal 
and the UMIPS system has been dropped. If this happens, you must reestablish con- 
tact with the computer (specifically, with the data switch that links your terminal to 
the computer) before trying to log in again. Since procedures for doing this vary from 
site to site, ask your system administrator to give you exact instructions for getting a 
connection on the data switch. 

If you have never logged in on the UMIPS system, your login procedure may differ 
from the one just described. This is because some system administrators follow the 
optional security procedure of assigning temporary passwords to new users when they 
set up their accounts. If you have a temporary password the system will force you to 
choose a new password before it allows you to log in. 

By forcing you to choose a password for your exclusive use, this extra step helps to 
ensure a system's security. Protection of system resources and your personal files 
depends on your keeping your password private. 

The actual procedure you follow will be determined by the administrative procedures 
at your computer installation site. However, it will probably be similar to the follow- 
ing example of a first-time login procedure, 

1. You establish contact; the UMIPS system displays the login: prompt. Type 
your login name and press the RETURN key. 

2. The UMIPS system prints the password prompt. Type your temporary pass- 
word and press the RETURN key. 

3. The system tells you your temporary password has expired and you must 
select a new one. 

4. The system asks you to type your old password again. Type your temporary 
password. 

5. The system prompts you to type your new password. Type the password you 
have chosen. 

Passwords must be constructed to meet the following requirements: 

□ Each password must have at least six characters. Only the first eight 
characters are significant. 

□ Each password must contain at least two alphabetic characters and at 
least one numeric or special character. Alphabetic characters can be 
upper case or lower case letters. 
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□ Each password must differ from your login name and any reverse or circu- 
lar shift of that login name. For comparison purposes, an upper case 
letter and its corresponding lower case letter are equivalent. 

□ A new password must differ from the old by at least three characters. 
For comparison purposes, an upper case letter and its corresponding 
lower case letter are equivalent. 

Examples of valid passwords are: mar84ch, JonathOn, and BRAV3S. 

The UMIPS system you are using may have different requirements to consider when 
choosing a password. Ask your system administrator for details. 



For verification, the system asks you to reenter your new password. Type 
your new password again. 

If you do not reenter the new password exactly as typed the first time, the sys- 
tem tells you the passwords do not match and asks you to try the procedure 
again. On some systems, however, the communication link may be dropped 
if you do not reenter the password exactly as typed the first time. If this hap- 
pens, you must return to step 1 and begin the login procedure again. When 
the passwords match, the system displays the prompt. 

The following example summarizes this procedure (steps 1 through 6) for first-time 
UMIPS system users. 

login: starship <CR> 

password: <CR> 

Your password has expired. 

Choose a new one. 

Old password: <CR> 

New password: <CR> 

Re-enter new password: <CR> 

$ 



Possible Problems when Logging In 

A terminal usually behaves predictably when you have configured it properly. Some- 
times, however, it may act peculiarly. For example, the carriage return may not work 
properly. 

Some problems can be corrected simply by logging off the system and logging in 
again. If logging in a second time does not remedy the problem, you should first 
check the following and try logging in once again: 

the keyboard Keys labeled CAPS, LOCAL, BLOCK, and so on should 

not be enabled (put into the locked position). You can 
usually disable these keys simply by pressing them. 

the data phone set If your terminal is connected to the computer 
or modem via telephone lines, verify that the baud rate and duplex 

settings are correctly specified. 



NOTE 

6. 

7. 
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the switches Some terminals have several switches that must be set to 

be compatible with the UMIPS system. If this is the case 
with the terminal you are using, make sure they are set 
properly. 

Refer to the section "Required Terminal Settings" in this chapter if you need informa- 
tion to verify the terminal configuration. If you need additional information about the 
keyboard, terminal, data phone, or modem, check the owner's manuals for the 
appropriate equipment. 

Figure 2-5 presents a list of procedures you can follow to detect, diagnose, and 
correct some problems you may experience when logging in. If you need further help, 
contact your system administrator. 
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Problemf 


Possible Cause 


Action/Remedy 


Meaningless characters 


UMIPS system at wrong speed 


Press RETURN or BREAK key 


Input/output appears in 
UrrJbK CAbli letters 


Terminal configuration 
includes UrrrsK tAat set- 
ting 


Log off and set character gen- 
eration to lower case 


Input appears in UPPER 
CASE, output in lower case 


Key labeled CAPS (or CAPS 
LOCK) is enabled 


Press CAPS or CAPS LOCK 
key to disable setting 


Input is printed twice 


Terminal is set to HALF 
DUPLEX mode 


Change setting to FULL 
DUPLEX mode 


Tab key does not work prop- 
erly 


Tabs are not set correctly 


Type stty — tabs$ 


Communication link cannot 
be established although high 
pitched tone is heard when 
dialing in 


Terminal is set to LOCAL or 
OFF-LINE mode 


Set terminal to ON-LINE mode 
try logging in again 


Communication link (termi- 
nal to UMIPS system) is 
repeatedly dropped 


Bad telephone line or bad 
communications port 


Call system administrator 



* Numerous problems can occur if your terminal is not configured properly. To eliminate 
these possibilities before attempting to log in, perform the configuration checks listed 
under "Required Terminal Settings." 

t Some problems may be specific to your terminal, data phone set, or modem. Check 
the owner's manual for the appropriate equipment if suggested actions do not remedy 
the problem. 

$ Typing stty —tabs corrects the tab setting only for your current computing session. To 
ensure a correct tab setting for all sessions, add the line stty —tabs to your .profile (see 
Chapter 7). 

Figure 2-5: Troubleshooting Problems When Logging In* 



Simple Commands 

When the prompt appears on your screen, the UMIPS system has recognized you as 
an authorized user and is waiting for you to request a program by entering a com- 
mand. 

For example, try running the date command. After the prompt, type the command 
and press the RETURN key. The UMIPS system accesses a program called date, 
executes it, and prints its results on the screen, as shown below. 

$ date<CR> 

Wed Oct 15 09:49:44 EDT 1986 
$ 

As you can see, the date command prints the date and time, using the 24-hour clock. 
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Now type the who command and press the RETURN key. Your screen will look 
something like this: 



$ who<CR> 



starship 


ttyOO 


Oct 


12 


8 


53 


mary2 


tty02 


Oct 


12 


8 


56 


acctl23 


ttyOS 


Oct 


12 


8 


54 


jmrs 


tty06 


Oct 


12 


8 


56 



$ 

The who command lists the login names of everyone currently working on your sys- 
tem. The tty designations refer to the special files that correspond to each user's ter- 
minal. The date and time at which each user logged in are also shown. 



Logging Off 

When you have completed a session with the UMIPS system, type <"d> after the 
prompt. (Remember that control characters such as <*d> are typed by holding down 
the control key and pressing the appropriate alphabetic key. Because they are non- 
printing characters, they do not appear on your screen.) After several seconds, the 
UMIPS system will display the login: prompt again. 

$ <Td> 
login: 

This shows that you have logged off successfully and the system is ready for someone 
else to log in. 



NOTE 



Always log off the UMIPS system by typing <~d> before you turn off the terminal or 
hang up the telephone. If you do not, you may not be actually logged off the system. 



The exit command also allows you to log off but is not used by most users. It may be 
convenient if you want to include a command to log off within a shell program. (For 
details, see the "Special Commands" section of the sh(l) page in the User's Reference 
Manual.) 



2-16 USER'S GUIDE 



Chapter 3: Using the File System 



Introduction 34 
How the File System is Structured 3-2 
Your Place in the File System 3-3 

Your Home Directory 3-3 
Your Current Directory 3-4 
Path Names 3-5 
Full Path Names 3-5 
Relative Path Names 3-6 
Naming Directories and Files 3-9 

Organizing a Directory 3-11 

Creating Directories: the mkdir Command 3-11 

Listing the Contents of a Directory: the Is Command 3-12 

Frequently Used Is Options 3-13 

Changing Your Current Directory: the cd Command 3-17 

Removing Directories: the rmdir Command 3-19 

Accessing and Manipulating Files 3-21 

Basic Commands 3-21 

Displaying a File's Contents: the cat, pg, and pr Commands 3-22 

Requesting a Paper Copy of a File: the lp Command 3-29 

Making a Duplicate Copy of a File: the cp Command 3-31 

Moving and Renaming a File: the mv Command 3-33 

Removing a File: the rm Command 3-35 

Counting Lines, Words, and Characters in a File: 

the wc Command 3-36 

Protecting Your Files: the chmod Command 3-38 

Advanced Commands 3-43 

Identifying Differences Between Files: the diff Command 3-43 

Searching a File for a Pattern: the grep Command 3-45 

Sorting and Merging Files: the sort Command 3-47 

Summary 3-49 



TABLE OF CONTENTS i 



c 



Introduction 



To use the UMIPS file system effectively you must be familiar with its structure, know 
something about your relationship to this structure, and understand how the relation- 
ship changes as you move around within it. This chapter prepares you to use this file 
system. 

The first two sections ("How the File System is Structured" and "Your Place in the 
File System") offer a working perspective of the file system. The rest of the chapter 
introduces UMIPS system commands that allow you to build your own directory struc- 
ture, access and manipulate the subdirectories and files you organize within it, and 
examine the contents of other directories in the system for which you have access per- 
mission. 

Each command is discussed in a separate subsection. Tables at the end of these sub- 
sections summarize the features of each command so that you can later review a 
command's syntax and capabilities quickly. Many of the commands presented in this 
section have additional, sophisticated uses. These, however, are left for more experi- 
enced users and are described in other UMIPS system documentation. All the com- 
mands presented here are basic to using the file system efficiently and easily. Try 
using each command as you read about it. 
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How the File System is Structured 



The file system is comprised of a set of ordinary files, special files, and directories. 
These components provide a way to organize, retrieve, and manage information elec- 
tronically. Chapter 1 introduced the properties of directories and files; this section 
will review them briefly before discussing how to use them. 

■ An ordinary file is a collection of characters stored on a disk. It may contain 
text for a report or code for a program. 

■ A special file represents a physical device, such as a terminal or disk. 

■ A directory is a collection of files and other directories (sometimes called sub- 
directories). Use directories to group files together on the basis of any criteria 
you choose. For example, you might create a directory for each product that 
your company sells or for each of your student's records. 

The set of all the directories and files is organized into a tree shaped structure. Fig- 
ure 3-1 shows a sample file structure with a directory called root (/) as its source. By 
moving down the branches extending from root, you can reach several other major 
system directories. By branching down from these, you can, in turn, reach all the 
directories and files in the file system. 

In this hierarchy, files and directories that are subordinate to a directory have what is 
called a parent/child relationship. This type of relationship is possible for many 
layers of files and directories. In fact, there is no limit to the number of files and 
directories you may create in any directory that you own. Neither is there a limit to 
the number of layers of directories that you may create. Thus you have the capability 
to organize your files in a variety of ways, as shown in Figure 3-1. 




- Directories 
| | = Ordinary Files 
\y = Special Files 



Figure 3-1: A Sample File System 
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Whenever you interact with the UMIPS system, you do so from a location in its file 
system structure. The UMIPS system automatically places you at a specific point in 
its file system every time you log in. From that point, you can move through the 
hierarchy to work in any of your directories and files and to access those belonging to 
others that you have permission to use. 

The following sections describe your position in the file system structure and how this 
position changes as you move through the file system. 



Your Home Directory 

When you successfully complete the login procedure, the UMIPS system places you at 
a specific point in its file system structure called your login or home directory. The 
login name assigned to you when your UMIPS system account was set up is usually 
the name of this home directory. Every user with an authorized login name has a 
unique home directory in the file system. 

The UMIPS system is able to keep track of all these home directories by maintaining 
one or more system directories that organize them. For example, the home direc- 
tories of the login names star ship, mary2, and jmrs are contained in a system direc- 
tory called userl. Figure 3-2 shows the position of a system directory such as userl 
in relation to the other important UMIPS system directories discussed in Chapter 1. 




J | = Ordinary Files 
\y =f Special Files 
= Branch 



Figure 3-2: Directory of Home Directories 
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Within your home directory, you can create files and additional directories (some- 
times called subdirectories) in which to group them. You can move and delete your 
files and directories, and you can control access to them. You have full responsibility 
for everything you create in your home directory because you own it. Your home 
directory is a vantage point from which to view all the files and directories it holds, 
and the rest of the file system, all the way up to root. 



Your Current Directory 

As long as you continue to work in your home directory, it is considered your current 
working directory. If you move to another directory, that directory becomes your 
new current directory. 

The UMIPS system command pwd (short for print working directory) prints the name 
of the directory in which you are now working. For example, if your login name is 
starship and you execute the pwd command in response to the first prompt after log- 
ging in, the UMIPS system will respond as follows: 

$ pwd<CR> 

/userl/starship 
$ 

The system response gives you both the name of the directory in which you are work- 
ing (starship) and the location of that directory in the file system. The path name 
/userl/starship tells you that the root directory (shown by the leading / in the 
line) contains the directory user! which, in turn, contains the directory starship. (All 
other slashes in the path name other than root are used to separate the names of 
directories and files, and to show the position of each directory relative to root.) A 
directory name that shows the directory's location in this way is called a full or com- 
plete directory name or path name. In the next few pages we will analyze and trace 
this path name so you can start to move around in the file system. 

Remember, you can determine your position in the file system at any time simply by 
issuing a pwd command. This is especially helpful if you want to read or copy a file 
and the UMIPS system tells you the file you are trying to access does not exist. You 
may be surprised to find you are in a different directory than you thought. 

Figure 3-3 provides a summary of the syntax and capabilities of the pwd command. 
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Command Recap 


pwd 


- print full name of working directory 


L/ L/l 1 l>l I I'Vtf VIA 


options arguments 


pwd 


none none 


Description: 


pwd prints the full path name of the directory in 
which you are currently working. 



Figure 3-3: Summary of the pwd Command 



Path Names 

Every file and directory in the UMIPS system is identified by a unique path name. 
The path name shows the location of the file or directory, and provides directions for 
reaching it. Knowing how to follow the directions given by a path name is your key to 
moving around the file system successfully. The first step in learning about these 
directions is to learn about the two types of path names: full and relative. 

Full Path Names 

A full path name (sometimes called an absolute path name) gives directions that start 
in the root directory and lead you down through a unique sequence of directories to a 
particular directory or file. You can use a full path name to reach any file or direc- 
tory in the UMIPS system in which you are working. 

Because a full path name always starts at the root of the file system, its leading char- 
acter is always a / (slash). The final name in a full path name can be either a file 
name or a directory name. All other names in the path must be directories. 

To understand how a full path name is constructed and how it directs you, consider 
the following example. Suppose you are working in the starship directory, located in 
/userl. You issue the pwd command and the system responds by printing the full 
path name of your working directory: /user 1/star ship. Analyze the elements of 
this path name using the following diagram and key. 



system 
directory 



root 



home 
directory 



delimiter 



lserl/starship 
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/ (leading) 


= the slash that appears as the first character in the path name 
is me rooi 01 me me system 


userl 


= system directory one level below root in the hierarchy to 
which root points or branches 


/ (subsequent) 


= the next slash separates or delimits the directory names 
userl and starship 


starship 


= current working directory 



Now follow the bold lines in Figure 3-4 to trace the full path to /userl/starship. 




Figure 3-4: Full Path Name of the /userl/starship Directory 



Relative Path Names 

A relative path name gives directions that start in your current working directory, and 
lead you up or down through a series of directories to a particular file or directory. 
By moving down from your current directory, you can access files and directories you 
own. By moving up from your current directory, you pass through layers of parent 
directories to the grandparent of all system directories, root. From there you can 
move anywhere in the file system. 

A relative path name begins with one of the following: a directory or file name; a . 
(pronounced dot), which is a shorthand notation for your current directory; or a .. 
(pronounced dot dot), which is a shorthand notation for the directory immediately 
above your current directory in the file system hierarchy. The directory represented 
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by (dot dot) is called the parent directory of . (your current directory). 

For example, say you are in the directory starship in the sample system and starship 
contains directories named draft, letters, and bin and a file named mbox. The rela- 
tive path name to any of these is simply its name, such as draft or mbox. Figure 3-5 
traces the relative path from starship to draft. 




Files 



Figure 3-5: Relative Path Name of the draft Directory 



The draft directory belonging to starship contains the files outline and table. The 
relative path name from starship to the file outline is draft/outline. 

Figure 3-6 traces this relative path. Notice that the slash in this path name separates 
the directory named draft from the file named outline. Here, the slash is a delimiter 
showing that outline is subordinate to draft; that is, outline is a child of its parent, 
draft. 
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Files 



Figure 3-6: Relative Path Name from starship to outline 



So far, the discussion of relative path names has covered how to specify names of 
files and directories that belong to, or are children of, your current directory. You 
now know how to move down the system hierarchy level by level until you reach your 
destination. You can also, however, ascend the levels in the system structure or 
ascend and subsequently descend into other files and directories. 

To ascend to the parent of your current directory, you can use the notation. This 
means that if you are in the directory named draft in the sample file system? is the 
path name to starship, and ../•• is the path name to starship's parent directory, 
userl. 

From draft, you can also trace a path to the file sanders by using the path name 
../letters/sanders. The brings you up to starship. Then the names letters and 
sanders take you down through the letters directory to the sanders file. 

Keep in mind that you can always use a full path name in place of a relative one. 

Figure 3-7 shows some examples of full and relative path names. 
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Path Name 


Meaning 


/ 


full path name of the root directory 


/bin 


full path name of the bin directory (contains 
most executable programs and utilities) 


/userl/starship/bin/tools 


full path name of the tools directory belonging 
to the bin directory that belongs to the star- 
ship directory belonging to userl that belongs 
to root 


bin/tools 


relative path name to the file or directory tools 
in the directory bin 

If the current directory is /, then the UMIPS 
system searches for /bin/tools. However, if 
the current directory is starship, then the sys- 
tem searches the full path 
/userl/starship/bin/tools . 


tools 


relative path name of a file or directory tools 
in the current directory. 



Figure 3-7: Example Path Names 



You may need some practice before you can use path names such as these to move 
around the file system with confidence. However, this is to be expected when learn- 
ing a new concept. 

Naming Directories and Files 

You can give your directories and files any names you want, as long as you observe 
the following rules: 

■ The name of a directory (or file) can be from one to 255 characters long. On 
many System V machines, the longest legal filename is 14 characters. If you 
intend to move your files to such a machine, you may wish to observe this 
limit. 

■ All characters other than / are legal. 

■ Some characters are best avoided, such as a space, tab, backspace, and the fol- 
lowing: 

\ | ; ' " < > 

If you use a blank or tab in a directory or file name, you must enclose the 
name in quotation marks on the command line. 

■ Avoid using a +, — or . as the first character in a file name. 
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■ Upper case and lower case characters are distinct to the UMIPS system. For 
example, the system considers a directory (or file) named draft to be different 
from one named DRAFT. 

■ The longest legal pathname is 1024 characters. 

The following are examples of legal directory or file names: 

memo MEMO section2 reftlist 

file.d chap3+4 item 1-10 outline 

The rest of this chapter introduces UMIPS system commands that enable you to 
examine the file system. 
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This section introduces four UMIPS system commands that enable you to organize 
and use a directory structure: mkdir, Is, cd, and rmdir. 

mkdir enables you to make new directories and subdirectories within 
your current directory 

Is lists the names of all the subdirectories and files in a directory 

cd enables you to change your location in the file system from 

one directory to another 

rmdir enables you to remove an empty directory 

These commands can be used with either full or relative path names. Two of the 
commands, Is and cd, can also be used without a path name. Each command is 
described more fully in the four sections that follow. 

Creating Directories: the mkdir Command 

It is recommended that you create subdirectories in your home directory according to 
a logical and meaningful scheme that will facilitate the retrieval of information from 
your files. If you put all files pertaining to one subject together in a directory, you 
will know where to find them later. 

To create a directory, use the command mkdir (short for make directory). Simply 
enter the command name, followed by the name you are giving your new directory or 
file. For example, in the sample file system, the owner of the draft subdirectory 
created draft by issuing the following command from the home directory 
(/userl/starship) : 

$ mkdir draft <CR> 

$ 

The second prompt shows that the command has succeeded; the subdirectory draft 
has been created. 

Still in the home directory, this user created other subdirectories, such as letters and 
bin, in the same way. 

$ mkdir letters<CR> 
$ mkdir bin<CR> 

$ 

The user could have created all three subdirectories (draft, letters, and bin) simul- 
taneously by listing them all on a single command line. 

$ mkdir draft letters bin<CR> 

$ 

You can also move to a subdirectory you created and build additional subdirectories 
within it. When you build directories or create files, you can name them anything you 
want as long as you follow the guidelines listed earlier under "Naming Directories and 
Files." 
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Figure 3-8 summarizes the syntax and capabilities of the mkdir command. 





^ oiiiiiidiiiu i\.t?cap 




mkdir - make a new directory 


command 


options arguments 


mkdir 


none directoryname(s) 


Description: 


mkdir creates a new directory (subdirectory). 


Remarks: 


The system returns a prompt ($ by default) if the 
directory is successfully created. 



Figure 3-8: Summary of the mkdir Command 



Listing the Contents of a Directory: the Is Command 

All directories in the file system have information about the files and directories they 
contain, such as name, size, and the date last modified. You can obtain this informa- 
tion about the contents of your current directory and other system directories by exe- 
cuting the command Is (short for list). 

The Is command lists the names of all files and subdirectories in a specified directory. 
If you do not specify a directory, Is lists the names of files and directories in your 
current directory. To understand how the Is command works, consider the sample 
file system (Figure 3-2) once again. 

Say you are logged in to the UMIPS system and you run the pwd command. The sys- 
tem responds with the path name /userl/starship. To display the names of files and 
directories in this current directory, you then type Is and press the RETURN key. 
After this sequence, your terminal will read: 

$ pwd<CR> 

$ /userl/starship 

$ ls<CR> 

bin 

draft 

letters 

list 

mbox 

$ 

As you can see, the system responds by listing, in alphabetical order, the names of 
files and directories in the current directory starship. (If the first character of any of 
the file or directory names had been a number or an upper case letter, it would have 
been printed first.) 
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To print the names of files and subdirectories in a directory other than your current 
directory without moving from your current directory, you must specify the name of 
that directory as follows: 

Is pathname<CR> 

The directory name can be either the full or relative path name of the desired direc- 
tory. For example, you can list the contents of draft while you are working in star- 
ship by entering Is draft and pressing the RETURN key. Your screen will look like 
this: 

$ Is draft<CR> 

outline 

table 

$ 

Here, draft is a relative path name from a parent (starship) to a child (draft) direc- 
tory. 

You can also use a relative path name to print the contents of a parent directory when 
you are located in a child directory. The .. (dot dot) notation provides an easy way to 
do this. For example, the following command line specifies the relative path name 
from starship to userl: 

$ Is ..<CR> 

jmrs 
mary2 
starship 
$ 

You can get the same results by using the full path name from root to userl. If you 
type Is /userl and press the RETURN key, the system will respond by printing the 
same list. 

Similarly, you can list the contents of any system directory that you have permission 
to access by executing the Is command with a full or relative path name. 

The Is command is useful if you have a long list of files and you are trying to deter- 
mine whether one of them exists in your current directory. For example, if you are in 
the directory draft and you want to determine if the files named outline and notes are 
there, use the Is command as follows: 

$ Is outline notes<CR> 

outline 

notes not found 
$ 

The system acknowledges the existence of outline by printing its name, and says that 
the file notes is not found. 

The Is command does not print the contents of a file. If you want to see what a file 
contains, use the cat, pg, or pr command. These commands are described in 
"Accessing and Manipulating Files," later in this chapter. 

Frequently Used Is Options 

The Is command also accepts options that cause specific attributes of a file or sub- 
directory to be listed. There are more than a dozen available options for the Is com- 
mands. Of these, the —a and —1 will probably be most valuable in your basic use of 
the UMIPS system. Refer to the ls(l) page in the User's Reference Manual for details 
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about other options. 
Listing All Names in a File 

Some important file names in your home directory, such as .profile (pronounced dot- 
profile), begin with a period. (As you can see from this example, when a period is 
used as the first character of a file name it is pronounced dot.) When a file name 
begins with a dot, it is not included in the list of files reported by the Is command. If 
you want the Is to include these files, use the —a option on the command line. 

For example, to list all the files in your current directory (starship), including those 
that begin with a . (dot), type Is -a and press the RETURN key. 

$ Is -a<CR> 



. profile 

bin 

draft 

letters 

list 

mbox 

$ 

Listing Contents in Short Format 

The — C and — F options for the Is command are frequently used. Together, these 
options list a directory's subdirectories and files in columns, and identify executable 
files (with an *) and directories (with a /). Thus, you can list all files in your working 
directory starship by executing the command line shown here: 

$ Is -CF<CR> 

bin/ letters/ mbox 

draft/ list* 

$ 

Listing Contents in Long Format 

Probably the most informative Is option is — 1, which displays the contents of a direc- 
tory in long format, giving mode, number of links, owner, group, size in bytes, and 
time of last modification for each file. For example, say you run the Is — 1 command 
while in the starship directory. 

$ Is -1<GR> 

total 30 



drwxr- 


-xr- 


-x 


3 


starship 


project 


96 


Oct 


27 


08: 


:16 


bin 


drwxr- 


-xr- 


-x 


2 


starship 


project 


64 


Nov 


1 


14: 


,19 


draft 


drwxr- 


-xr- 


-x 


2 


starship 


project 


80 


Nov 


3 


08: 


i41 


letters 


-rwx— 






2 


starship 


proj ect 


12301 


Nov 


2 


10: 


il5 


list 


-rw — 






1 


starship 


project 


40 


Oct 


27 


10: 


tOO 


mbox 



s 

The first line of output (total 30) shows the amount of disk space used, measured 
in blocks. Each of the rest of the lines comprises a report on a directory or file in 
starship. The first character in each line (d, -, b, or c) tells you the type of file. 



3-14 USER'S GUIDE 



Organizing a Directory 



d 



directory 



ordinary disk file 



b 



block special file 



c 



character special file 



Using this key to interpret the previous example, you can see that the starship direc- 
tory contains three directories and two ordinary disk files. 

The next several characters, which are either letters or hyphens, identify who has per- 
mission to read and use the file or directory. (Permissions are discussed in the 
description of the chmod command under "Accessing and Manipulating Files" later in 
this chapter.) 

The following number is the link count. For a file, (A file may be assigned multiple 
names with the ln(l) command.) this equals the number of names for that file. For a 
directory, this number shows the number of directories immediately under it plus two 
(for the directory itself,".", and its parent directory, ".."). 

Next, the login name of the file's owner appears (here it is starship), followed by the 
group name of the file or directory (project). 

The following number shows the length of the file or directory entry measured in units 
of information (or memory) called bytes. The month, day, and time that the file was 
last modified is given next. Finally, the last column shows the name of the directory 
or file. 

Figure 3-9 identifies each column in the rows of output from the Is —1 command. 
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File 
type 



number of 
blocks used 



owner 
name 



number 
of links 



total 30 



rwxr-xr-x 
rwxr-xr-x 
rwxr-xr-x 

- |rwx-- ■ — • 

- rw- — 



permissions 



group 
name 



3 star ship project 96 

2 starship project 64 

2 starship project 80 

2 starship project 12301 

1 starship project 40 



Oct 27 08:16 
Nov 1 14:19 
Nov 8 08: 41 
Nov 2 10: 15 

Oct 27 10: 00 



name 



bin 
draft 
letters 
list 
mbox 



time/date last 
modified 



Figure 3-9: Description of Output Produced by the Is — 1 Command 



Figure 3-10 summarizes the syntax and capabilities of the Is command and two avail- 
able options. 



3-16 USER'S GUIDE 



Organizing a Directory 





Command Recap 




Is - list contents of a directory 


command 


options arguments 


Is 


—a, —I, and others* directoryname(s) 


Description: 


Is lists the names of the files and subdirectories in 
the specified directories. If no directory name is 
given as an argument, the contents of your work- 
ing directory are listed. 


Options: 


—a Lists all entries, including those beginning 
with . (dot). 

—1 Lists contents of a directory in long for- 
mat furnishing mode, permissions, size in 
bytes, and time of last modification. 


Remarks: 


If you want to read the contents of a file, use the 
cat command. 



* See the ls(l) page in the User's Reference Manual for all available options and an expla- 
nation of their capabilities. 

Figure 3-10: Summary of the Is Command 



Changing Your Current Directory: the cd Command 

When you first log in on the UMIPS system, you are placed in your home directory. 
As long as you do work in it, it is also your current working directory. However, by 
using the command cd (short for change directory), you can work in other directories 
as well. To use this command, enter cd, followed by a path name to the directory to 
which you want to move. 

cd pathname_of_newdirectory<CR> 

Any valid path name (full or relative) can be used as an argument to the cd com- 
mand. If you do not specify a path name, the command will move you to your home 
directory. Once you have moved to a new directory, it becomes your current direc- 
tory. 

For example, to move from the starship directory to its child directory draft (in the 
sample file system), type cd draft and press the RETURN key. (Here draft is the 
relative path name to the desired directory.) When you get a prompt, verify your new 
location by typing pwd and pressing the RETURN key. Your terminal screen will 
look like this: 
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$ cd draft<CR> 
$ pwd<CR> 

/userl/starship/draft 
$ 

Now that you are in the draft directory you can create subdirectories in it by using the 
mkdir command, and new files, by using the ed and vi editors. (See Chapters 5 and 6 
for tutorials on the ed and vi commands, respectively.) 

It is not necessary to be in the draft directory to access files within it. You can 
access a file in any directory by specifying a full path name for it. For example, to 
cat the sandcrs file in the letters directory (/userl/starship/letters) while you are in 
the draft directory (/userl/starship/draft), specify the full path name of sanders on 
the command line. 

cat /userl/starship/letters/sanders<CR> 

You may also use full path names with the cd command. For example, to move to 
the letters directory from the draft directory, specify /userl/starship/letters on the 
command line, as follows: 

cd /userl/starship/letters<CR> 

Also, because letters and draft are both children of starship, you can use the relative 
path name ../letters with the cd command. The .. notation moves you to the direc- 
tory starship, and the rest of the path name moves you to letters. 

Figure 3-11 summarizes the syntax and capabilities of the cd command. 





Command Recap 




cd - change your working directory 


command 


options arguments 


cd 


none directoryname 


Description: 


cd changes your position in the file system from the 
current directory to the directory specified. If no 
directory name is given as an argument, the cd 
command places you in your home directory. 


Remarks: 


When the shell places you in the directory 
specified, the prompt ($ by default) is returned to 
you. To access a directory that is not in your 
working directory, you must use the full or relative 
path name in place of a simple directory name. 



Figure 3-11: Summary of the cd Command 
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Removing Directories: the rmdir Command 

If you no longer need a directory, you can remove it with the command rmdir (short 
for remove a directory). The standard syntax for this command is: 

rmdir directoryname(s)<CR> 

You can specify more than one directory name on the command line. 

The rmdir command will not remove a directory if you are not the owner of it or if 
the directory is not empty. If you want to remove a file in another user's directory, 
the owner must give you write permission for the parent directory of the file you want 
to remove. 

If you try to remove a directory that still contains subdirectories and files (that is, is 
not empty), the rmdir command prints the message directoryname not empty. You 
must remove all subdirectories and files; only then will the command succeed. 

For example, say you have a directory called memos that contains one subdirectory, 
tech, and two files, june.30 and juiy.31. (Create this directory in your home directory 
now so you can see how the rmdir command works.) If you try to remove the direc- 
tory memos (by issuing the rmdir command from your home directory), the command 
responds as follows: 

$ rmdir memos<CR> 

rmdir : memos not empty 
$ 

To remove the directory memos, you must first remove its contents: the subdirectory 
tech, and the files june.30 and july.31. You can remove the tech subdirectory by exe- 
cuting the rmdir command. For instructions on removing files, see "Accessing and 
Manipulating Files" later in this chapter. 

Once you have removed the contents of the memos directory, memos itself can be 
removed. First, however, you must move to its parent directory (your home direc- 
tory). The rmdir command will not work if you are still in the directory you want to 
remove. From your home directory, type: 

rmdir memos<CR> 

If memos is empty, the command will remove it and return a prompt. 

Figure 3-12 summarizes the syntax and capabilities of the rmdir command. 
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Command Recap 
rmdir - remove a directory 



command options arguments 



rmdir none directoryname(s) 



Description: rmdir removes specified directories if they do not 
contain files and/or subdirectories. 

Remarks: If the directory is empty, it is removed and the 

system returns a prompt. If the directory con- 
tains files or subdirectories, the command returns 
the message, rmdir : directoryname not 
empty. 



Figure 3-12: Summary of the rmdir Command 
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This section introduces several UMIPS system commands that access and manipulate 
files in the file system structure. Information in this section is organized into two 
parts; basic and advanced. The part devoted to basic commands is fundamental to 
using the file system; the advanced commands offer more sophisticated information 
processing techniques for working with files. 



Basic Commands 

This section discusses UMIPS system commands that are necessary for accessing and 
using the files in the directory structure. Figure 3-13 lists these commands. 



Command 


Function 


cat 


prints the contents of a specified file 
on a terminal 


Pg 


prints the contents of a specified file 
on a terminal in chunks or pages 


pr 


prints a partially formatted version of a 
specified file on the terminal 


IP 


requests a paper copy of a file from a 
line printer 


cp 


makes a duplicate copy of an existing 
file 


mv 


moves and renames a file 


rm 


removes a file 


wc 


reports the number of lines, words, 
and characters in a file 


chmod 


changes permission modes for a file 
(or a directory) 



Figure 3-13: Basic Commands for Using Files 
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Each command is discussed in detail and summarized in a table that you can easily 
reference later. These tables will allow you to review the syntax and capabilities of 
these commands at a glance. 

Displaying a File's Contents: the cat, pg, and pr Commands 

The UMIPS system provides three commands for displaying and printing the contents 
of a file or files: cat, pg, and pr. The cat command (short for concatenate) outputs 
the contents of the file(s) specified. This output is displayed on your terminal screen 
unless you tell cat to direct it to another file or a new command. 

The pg command is particularly useful when you want to read the contents of a long 
file because it displays the text of a file in pages a screenful at a time. The pr com- 
mand formats specified files and displays them on your terminal or, if you so request, 
directs the formatted output to a printer (see the Ip command in this chapter). 

The following sections describe how to use the cat, pg, and pr commands. 
Concatenate and Print Contents of a File: the cat Command 

The cat command displays the contents of a file or files. For example, say you are 
located in the directory letters (in the sample file system) and you want to display the 
contents of the file Johnson. Type the command line shown below and you will 
receive the following output: 

$ cat johnson<CR> 

March 5, 1986 

Mr. Ron Johnson 
Layton Printing 
52 Hudson Street 
New York, N.Y. 

Dear Mr. Johnson: 

I enjoyed speaking with you this morning 

about your company's plans to automate 

your business . 

Enclosed please find 

the material you requested 

about AB&C's line of computers 

and office automation software . 

If I can be of further assistance to you, 
please don't hesitate to call , 

Yours truly, 

John Howe 
$ 

To display the contents of two (or more) files, simply type the names of the files you 
want to see on the command line. For example, to display the contents of the files 
Johnson and sanders, type: 

$ cat johnson sanders<CR> 
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The cat command reads johnson and sanders and displays their contents in that 
order on your terminal. 

$ cat johnson sanders<CR> 

March 5, 1986 

Mr. Ron Johnson 
Layton Printing 
52 Hudson Street 
New York, N.Y. 

Dear Mr. Johnson: 

I enjoyed speaking with you this morning 



Yours truly, 

John Howe 

March 5, 1986 

Mrs. D.L. Sanders 
Sanders Research, Inc. 
43 Nassau Street 
Princeton, N.J. 

Dear Mrs . Sanders : 

My colleagues and I have been following, with great interest, 



Sincerely, 

John Howe 
$ 

To direct the output of the cat command to another file or to a new command, see 
the sections in Chapter 7 that discuss input and output redirection. 

Figure 3-14 summarizes the syntax and capabilities of the cat command. 
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Command Recap 


cat - 


- concatenate and print a file's contents 


command 


options arguments 


cat 


available* filename(s) 


Description: 


The cat command reads the name of each file 
specified on the command line and displays its 
contents. 


Remarks: 


If a specified file exists and is readable, its con- 
tents are displayed on the terminal screen; other- 
wise, the message cat : cannot open filename 
appears on the screen. 

To display the contents of a directory, use the Is 
command. 



* See the cat(l) page in the User's Reference Manual for all available options 
and an explanation of their capabilities. 

Figure 3-14: Summary of the cat Command 



Paging Through the Contents of a File: the pg Command 

The command pg (short for page) allows you to examine the contents of a file or 
files, page by page, on a terminal. The pg command displays the text of a file in 
pages (chunks) followed by a colon prompt (:), a signal that the program is waiting for 
your instructions. Possible instructions you can then issue include requests for the 
command to continue displaying the file's contents a page at a time, and a request 
that the command search through the file(s) to locate a specific character pattern. 
Figure 3-15 summarizes some of the available instructions. 
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Command* 


Function 


h 


help; display list of available pgf commands 


q or Q 


UUll |Jg UCI Uodl II1UUC 


<CR> 


disnlav next oace of text 


1 


display next line of text 


d or A d 


display additional half page of text 


• or 1 


reuiopiay curi ciii page ui icai 


f 


skip next page of text and display following one 


n 


begin displaying next file you specified 

on command line 


P 


display previous file specified on command line 




Gispiay lasi page 01 lexi in me currently uiopidyeu 


/pattern 


search forward in file for specified character pat- 
tern 


^pattern 


search backward in file for specified character 
pattern 



* Most commands can be typed with a number preceding them. For example, 
+1 (display next page), -1 (display previous page), or 1 (display first page of 
text). 

f See the User's Reference Manual for a detailed explanation of all available pg 
commands. 

Figure 3-15: Summary of Commands to Use with pg 



The pg command is useful when you want to read a long file or a series of files 
because the program pauses after displaying each page, allowing time to examine it. 
The size of the page displayed depends on the terminal. For example, on a terminal 
capable of displaying twenty-four lines, one page is defined as twenty-three lines of 
text and a line containing a colon. However, if a file is less than twenty-three lines 
long, its page size will be the number of lines in the file plus one (for the colon). 

To peruse the contents of a file with pg, use the following command line format: 

pg filename(s)<CR> 

For example, to display the contents of the file outline in the sample file system, type: 
pg outline<CR> 

The first page of the file will appear on the screen. Because the file has more lines in 
it than can be displayed on one page, a colon appears at the bottom of the screen. 
This is a reminder to you that there is more of the file to be seen. When you are 
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ready to read more, press the RETURN key and pg will print the next page of the 
file. 

The following example summarizes our discussion of the pg command this far. 
$ pg outline<CR> 

After you analyze the subject for your 
report , you must consider organizing and 
arranging the material you want to use in 
writing it . 



An outline is an effective method of 

organizing the material . The outline 

is a type of blueprint or skeleton , 

a framework for you the builder-writer 

of the report; in a sense it is a recipe 

:<CR> 

After you press the RETURN key, pg will resume printing the file's contents on the 
screen. 

that contains the names of the 
ingredients and the order in which 
to use them. 



Your outline need not be elaborate or 
overly detailed; it is simply a guide you 
may consult as you write, to be varied, 
if need be, when additional important 
ideas are suggested in the actual writing. 
(EOF) : 

Notice the line at the bottom of the screen containing the string (EOF) : . This 
expression ( EOF ) means you have reached the end of the file. The colon prompt is a 
cue for you to issue another command. 

When you have finished examining the file, press the RETURN key; a prompt will 
appear on your terminal. (Typing q or Q and pressing the RETURN key also gives 
you a prompt.) Or you can use one of the other available commands, depending on 
your needs. In addition, there are a number of options that can be specified on the 
pg command line (see the pg(l) page in the User's Reference Manual)* 

Proper execution of the pg command depends on specifying the type of terminal you 
are using. This is because the pg program was designed to be flexible enough to run 
on many different terminals; how it is executed differs from terminal to terminal. By 
specifying one type, you are telling this command: 

■ how many lines to print 

■ how many columns to print 

■ how to clear the screen 
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■ how to highlight prompt signs or other words 

■ how to erase the current line 

To specify a terminal type, assign the code for your terminal to the TERM variable in 
your .profile file. (For more information about TERM and .profile, see Chapter 7; 
for instructions on setting the TERM variable, see Appendix F.) 

Figure 3-16 summarizes the syntax and capabilities of the pg command. 





Command Recap 


pg - 


display a file's contents in chunks or pages 


command 


options arguments 


Pg 


available* filename(s) 


Descriptions 


The pg command displays the contents of the 
specified file(s) in pages. 


Remarks: 


After displaying a page of text, the pg com- 
mand awaits instructions from you to do one 
of the following: continue to display text, 
search for a pattern of characters, or exit the 
pg perusal mode. In addition, a number of 
options are available. For example, you can 
display a section of a file beginning at a 
specific line or at a line containing a certain 
sequence or pattern. You can also opt to go 
back and review text that has already been 
displayed. 



* See the pg(l) page in the User's Reference Manual for all available options 
and an explanation of their capabilities. 

Figure 3-16: Summary of the pg Command 



Print Partially Formatted Contents of a File: the pr Command 

The pr command is used to prepare files for printing. It supplies titles and headings, 
paginates, and prints a file, in any of various page lengths and widths, on your termi- 
nal screen. 

You have the option of requesting that the command print its output on another dev- 
ice, such as a line printer (read the discussion of the lp command in this section). 
You can also direct the output of pr to a different file (see the sections on input and 
output redirection in Chapter 7). 
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If you choose not to specify any of the available options, the pr command produces 
output in a single column that contains sixty-six lines per page and is preceded by a 
short heading. The heading consists of five lines: two blank lines; a line containing 
the date, time, file name, and page number; and two more blank lines. The format- 
ted file is followed by five blank lines. (Complete sets of text formatting tools are 
available on UMIPS systems equipped with the Documented s Workbench Software. 
Check with your system administrator to see if this software is available to you.) 

The pr command is often used together with the lp command to provide a paper copy 
of text as it was entered into a file. (See the section on the lp command for details.) 
However, you can also use the pr command to format and print the contents of a file 
on your terminal. For example, to review the contents of the file johnson in the sam- 
ple file system, type: 

pr johnson<CR> 

The following example gives an example of output from this command. 
$ pr johnson<CR> 



Mar 5 15: 43 1986 johnson Page 1 



March 5, 1986 

Mr. Ron Johnson 
Layton Printing 
52 Hudson Street 
New York, N.Y. 



Dear Mr . Johnson : 

I enjoyed speaking with you this morning 

about your company's plans to automate 

your business . 

Enclosed please find 

the material you requested 

about AB&C's line of computers 

and office automation software . 

If I can be of further assistance to you, 
please don't hesitate to call . 

Yours truly, 

John Howe 

$ 

The ellipses after the last line in the file represent the remaining lines (all blank in this 
case) that pr formatted into the output (so that each page contains a total of sixty-six 
lines). If you are working on a video display terminal, which allows you to view 
twenty-four lines at a time, the entire sixty-six lines of the formatted file will be 
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printed rapidly without pause. This means that the first forty-two lines will roll off 
the top of your screen, making it impossible for you to read them unless you have the 
ability to roll back a screen or two. However, if the file you are examining is particu- 
larly long, even this ability may not be sufficient to allow you to read the file. 

In such cases, type < A s> (control- s) to interrupt the flow of printing on your screen. 
When you are ready to continue, type <*q> (control-q) to resume printing. 

Figure 3-17 summarizes the syntax and capabilities of the pr command. 



Command Recap 
pr - print formatted contents of a file 


command 


options arguments 


pr 


available* filename(s) 


Description: 


The pr command produces a formatted copy 
of a file(s) on your terminal screen unless you 
specify otherwise. It prints the text of the 
file(s) on sixty-six line pages, and places five 
blank lines at the bottom of each page and a 
five-line heading at the top of each page. The 
heading includes: two blank lines; a line con- 
taining the date, time, file name, and page 
number; and two additional blank lines. 


Remarks: 


If a specified file exists, its contents are for- 
matted and displaye; if not, the message pr : 
can't open filename is printed. 

The pr command is often used with the lp 
command to produce a paper copy of a file. It 
can also be used to review a file on a video 
display terminal. To stop and restart the 
printing of a file on a terminal, type <"s> and 
<"q>, respectively. 



* See the pr(l) page in the User's Reference Manual for all available options and 
an explanation of their capabilities. 

Figure 3-17: Summary of the pr Command 



Requesting a Paper Copy of a File: the lp Command 

Some terminals have built-in printers that allow you to get paper copies of files. If 
you have such a terminal, you can get a paper copy of your file simply by turning on 
the printer and executing the cat or pr command. However, if you are using a video 
display terminal, you must send a request for a paper copy of a file to a printer (see 
Figure 3-18). The command lp (short for line printer) allows you to do this. 
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Figure 3-18: Examples of Teletype Model 40 Line Printers 



To execute lp, follow this format: 
Ip filename<CR> 

For example, to print the file johnson on a line printer, type the following command 
line: 

lp johnson<CR> 

The system responds with the name (or type) of the printer on which the file will be 
printed, and an identification (ID) number for your request. 

$ lp johnson<CR> 

request id is laser-6885 (1 file) 
$ 

The system response shows that your job is to be printed on a laser printer (this 
system's default type of printer), has a request ID number of 6885, and includes one 
file. 

The -Adest (short for destination) option on the command line causes your file to be 
printed on another available device that you specify in the dest argument. The -m 
option causes mail to be sent to you stating the job has been completed. 

To cancel a request to a printer, type the command cancel and specify the request ID 
number. For example, to cancel your request for a printing of the file letters (request 
ID laser-6885), type: 

cancel laser-6885<CR> 
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To check the status of a line printer job that it is in progress, or to get its request ID 
number, execute the Ipstat command. This command also provides a complete listing 
of every printer available on your system. Which printers are available to you 
depends on your UMIPS system facility. Ask your system administrator for the 
names of available line printers, or type the following command line: 

Ipstat -v<CR> 

Figure 3-19 summarizes the syntax and capabilities of the Ip command. 





Command Recap 


Ip 


- request paper copy of file from a line printer 


command 


options arguments 


IP 


— d, — m, and others* flle(s) 


Description: 


The Ip command requests that specified files 
be printed by a line printer, thus providing 
paper copies of the contents. 


Options: 


— ddest Allows you to choose dest as the 

printer or type of printer to produce 
the paper copy. If you do not use 
this option, the Ip program specifies 
the printer for you. 

— m Sends a message to you via mail after 
the printing is complete. 


Remarks: 


You can cancel a request to the line printer by 
typing cancel and the request ID furnished to 
you by the system when the request was ack- 
nowledged. 

Check with your system administrator for 
information on additional and/or different 
commands for printers that may be available at 
your location. 



See the lp(l) page in the User's Reference Manual for all available options and 
an explanation of their capabilities. 

Figure 3-19: Summary of the Ip Command 



Making a Duplicate Copy of a File: the cp Command 

When using the UMIPS system, you may want to make a copy of a file. For example, 
you might want to revise a file while leaving the original version intact. The command 
cp (short for copy) copies the complete contents of one file into another. The cp 
command also allows you to copy one or more files from one directory into another 
while leaving the original file or files in place. 
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To copy the file named outline to a file named new.outline in the sample directory, 
simply type cp outline new.outline and press the RETURN key. The system returns 
the prompt when the copy is made. To verify the existence of the new file, you can 
type Is and press the RETURN key. This command lists the names of all files and 
directories in the current directory, in this case draft. The following example sum- 
marizes these activities. 

$ cp outline new.outline<CR> 
$ ls<CR> 

new. outline 

outline 

table 

$ 

The UMIPS system does not allow you to have two files with the same name in a 
directory. In this case, because there was no file called new.outline when the cp com- 
mand was issued, the system created a new file with that name. However, if a file 
called new.outline had already existed, it would have been replaced by a copy of the 
file outline; the previous version of new.outline would have been deleted. 

If you had tried to copy the file outline to another file named outline in the same 
directory, the system would have told you the file names were identical and returned 
the prompt to you. If you had then listed the contents of the directory to determine 
exactly how many copies of outline existed, you would have received the following 
output on your screen: 

$ cp outline outline<CR> 

cp: outline and outline are identical 

$ ls<CR> 

outline 

table 

$ 

The UMIPS system does allow you to have two files with the same name as long as 
they are in different directories. For example, the system would let you copy the file 
outline from the draft directory to another file named outline in the letters directory. 
If you were in the draft directory, you could use any one of four command lines. In 
the first two command lines, you specify the name of the new file you are creating by 
making a copy. 

■ cp outline /userl/starship/letters/outline<CR> (full path name specified) 

■ cp outline ../letters/outline<CR> (relative path name specified) 

However, the cp command does not require that you specify the name of the new file. 
If you do not include a name for it on the command line, cp gives your new file the 
same name as the original one, by default. Therefore you could also use either of 
these command lines: 

■ cp outline /userl/starship/letters<CR> (full path name specified) 

■ cp outline ../letters<CR> (relative path name specified) 
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In any of these four cases, cp will make a copy of the outline file in the letters direc- 
tory and call it outline, too. 

Of course, if you want to give your new file a different name, you must specify it. For 
example, to copy the file outline in the draft directory to a file named outline.vers2 in 
the letters directory, you can use either of the following command lines: 

■ cp outline /userl/starship/letters/outline.vers2<CR> (full path name) 

■ cp outline ../letters/outline.vers2<CR> (relative path name) 

When assigning new names, keep in mind the conventions for naming directories and 
files described in "Naming Directories and Files" in this chapter. 

Figure 3-20 summarizes the syntax and capabilities of the cp command. 





Command Recap 




cp - make a copy of a file 


command 


options arguments 


cp 


filel file2 
none file(s) directory 


Description: 


cp allows you to make a copy of filel and call 
it filel leaving filel intact or to copy one or 
more files into a different directory. 


Remarks: 


When you are copying filel to filel and a file 
called filel already exists, the cp command 
overwrites the first version of filel with a copy 
of filel and calls it filel. The first version of 
filel is deleted. 

You cannot copy directories with the cp com- 
mand. 



Figure 3-20: Summary of the cp Command 



Moving and Renaming a File: the mv Command 

The command mv (short for move) allows you to rename a file in the same directory 
or to move a file from one directory to another. If you move a file to a different 
directory, the file can be renamed or it can retain its original name. 

To rename a file within one directory, follow this format: 

mv filel filel<CR> 
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The mv command changes a file's name from filel to file2 and deletes filel. 
Remember that the names filel and file2 can be any valid names, including path 
names. 

For example, if you are in the directory draft in the sample file system and you would 
like to rename the file table to new.table, simply type mv table new.table and press 
the RETURN key. If the command executes successfully, you will receive a prompt. 
To verify that the file new.table exists, you can list the contents of the directory by 
typing Is and pressing the RETURN key. The example shows your input and the 
system's output as follows: 

$ mv table new.table<CR> 
$ ls<CR> 

new.table 

outline 

$ 

You can also move a file from one directory to another, keeping the same name or 
changing it to a different one. To move the file without changing its name, use the 
following command line: 

mv file(s) directory<CR> 

The file and directory names can be any valid names, including path names. 

For example, say you want to move the file table from the current directory named 
draft (whose full path name is /userl/starship/draft) to a file with the same name in 
the directory letters (whose relative path name from draft is ../letters and whose full 
path name is /userl/starship/letters) , you can use any one of several command lines, 
including the following: 

mv table /userl/starship/letters<CR> 

mv table /userl/starship/letters/table<CR> 

mv table ../letters<CR> 

mv table *./letters/table<CR> 

mv /userl/starship/draft/table /userl/starship/letters/table<CR> 

Now suppose you want to rename the file table as table! when moving it to the direc- 
tory letters. Use any of these command lines: 

mv table /userl/starship/letters/table2<CR> 
mv table ../letters/table2<CR> 

mv /userl/starship/draft/table2 /userl/starship/letters/table2<CR> 

You can verify that the command worked by using the Is command to list the contents 
of the directory. 
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Figure 3-21 summarizes the syntax and capabilities of the mv command. 





Command Recap 




mv - move or rename files 


COfTlfflUflu 


Options urgUrnemS 


mv 


filel file2 
none file(s) directory 


Description: 


mv allows you to change the name of a file or 
to move a file(s) into another directory. 


Remarks: 


When you are moving filel to file2> if a file 
called file! already exists, the mv command 
overwrites the first version of file2 with filel 
and renames it filel. The first version of file! 
is deleted. 



Figure 3-21: Summary of the mv Command 



Removing a File: the rm Command 

When you no longer need a file, you can remove it from your directory by executing 
the command rm (short for remove). The basic format for this command is: 

rm file(s)<CR> 

You can remove more than one file at a time by specifying those files you want to 
delete on the command line with a space separating each filename: 

rm filel file2 file3<CR> 

The system does not save a copy of a file it removes; once you have executed this 
command, your file is removed permanently. 

After you have issued the rm command, you can verify its successful execution by 
running the is command. Since is lists the files in your directory, you'll immediately 
be able to see whether or not rm has executed successfully. 

For example, say you have a directory that contains two files, outline and table. You 
can remove both files by issuing the rm command once. If rm is executed success- 
fully, your directory will be empty. Verify this by running the Is command. 

$ rm outline table <CR> 
$ Is 

$ 

The prompt shows that outline and table were removed. 
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Figure 3-22 summarizes the syntax and capabilities of the rm command. 





Command Recap 






rm - remove a file 




command 


options 


arguments 


rm 


available* 


file(s) 


Description: 


rm allows you to remove one or more files. 


Remarks: 


Files specified as arguments to the rm com- 
mand are removed permanently. 



* See the rm(l) page in the User's Reference Manual for all available options 
and an explanation of their capabilities. 

Figure 3-22: Summary of the rm Command 



Counting Lines, Words, and Characters in a File: the wc Command 

The command wc (short for word count) reports the number of lines, words, and 
characters there are in the file(s) named on the command line. If you name more 
than one file, the wc program counts the number of lines, words, and characters in 
each specified file and then totals the counts. In addition, you can direct the wc pro- 
gram to give you only a line, a word, or a character count by using the —1, — w, or — c 
options, respectively. 

To determine the number of lilies, words, and characters in a file, use the following 
format on the command line: 

wc filel<CR> 

The system responds with a line in the following format: 
I w c filel 

where 

■ / represents the number of lines in filel 

■ w represents the number of words in filel 

■ c represents the number of characters in filel 

For example, to count the lines, words, and characters in the file johnson (located in 
the current directory, letters), type the following command line: 

$ wc johnson<CR> 

24 66 406 johnson 

$ 

The system response means that the file johnson has twenty-four lines, sixty-six 
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words, and 406 characters. 

To count the lines, words, and characters in more than one file, use this format: 

wc filel file2<CR> 

The system responds in the following format: 

/ w c filel 
I w c filel 
I w c total 

Line, word, and character counts for filel and filel are displayed on separate lines 
and the combined counts appear on the last line beside the word total. 

For example, ask the wc program to count the lines, words, and characters in the files 
johnson and senders in the current directory. 

$ wc johnson sanders<CR> 



24 


66 


406 


johnson 


28 


92 


559 


sanders 


52 


158 


965 


total 



$ 

The first line reports that the johnson file has twenty-four lines, sixty-six words, and 
406 characters. The second line reports twenty-eight lines, ninety-two words, and 
559 characters in the sanders file. The last line shows that these two files together 
have a total of fifty-two lines, 158 words, and 965 characters. 

To get only a line, a word, or a character count, select the appropriate command line 
format from the following lines: 

wc — 1 filel<CR> (line count) 
wc -w filel<CR> (word count) 
wc -c filel<CR> (character count) 

For example, if you use the —1 option, the system reports only the number of lines in 
sanders. 

$ wc —1 sanders<CR> 

28 sanders 

$ 

If the -w or -c option had been specified instead, the command would have reported 
the number of words or characters, respectively, in the file. 

Figure 3-23 summarizes the syntax and capabilities of the wc command. 
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Command Recap 


wc 


- count lines j words, and characters in a file 


command 


options arguments 


wc 


-l 9 -w, file(s) 


Descriptions 


wc counts lines, words, and characters in the 
specified file(s), keeping a total count of all tallies 
when more than one file is specified. 


Options 


-1 counts the number of lines in the specified 
file(s) 

-w counts the number of words in the 
specified file(s) 

-c counts the number of characters in the 
specified file(s) 


Remarks: 


When a file name is specified in the command line, 
it is printed with the count(s) requested. 



Figure 3-23: Summary of the wc Command 



Protecting Your Files: the chmod Command 

The command chmod (short for change mode) allows you to decide who can read, 
write, and use your files and who cannot. Because the UMIPS operating system is a 
multi-user system, you usually do not work alone in the file system. System users can 
follow path names to various directories and read and use files belonging to one 
another, as long as they have permission to do so. 

If you own a file, you can decide who has the right to read it, write in it (make 
changes to it), or, if it is a program, to execute it. You can also restrict permissions 
for directories with the chmod command. When you grant execute permission for a 
directory, you allow the specified users to cd to it and list its contents with the Is 
command. 

To assign these types of permissions, use the following three symbols: 
r allows system users to read a file or to copy its contents 
w allows system users to write changes into a file (or a copy of it) 
x allows system users to run an executable file 

To specify the users to whom you are granting (or denying) these types of permission, 
use these three symbols: 
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u you, the owner of your files and directories (u is short for user) 

g members of the group to which you belong (the group could consist of 
team members working on a project, members of a department, or a group 
arbitrarily designated by the person who set up your UMIPS system 
account) 

o all other system users 

When you create a file or a directory, the system automatically grants or denies per- 
mission to you, members of your group, and other system users. You can alter this 
automatic action by modifying your environment (see Chapter 7 for details). More- 
over, regardless of how the permissions are granted when a file is created, as the 
owner of the file or directory you always have the option of changing them. For 
example, you may want to keep certain files private and reserve them for your 
exclusive use. You may want to grant permission to read and write changes into a file 
to members of your group and all other system users as well. Or you may share a 
program with members of your group by granting them permission to execute it. 

How to Determine Existing Permissions 

You can determine what permissions are currently in effect on a file or a directory by 
using the command that produces a long listing of a directory's contents: Is -1. For 
example, typing Is -1 and pressing the RETURN key while in the directory named 
starship/bin in the sample file system produces the following output: 

$ Is -1<CR> 

total 35 

-rwxr-xr-x 1 starship project 9346 Nov 1 08 : 06 display 
-rw-r — r — 1 starship project 6428 Dec 2 10 : 24 list 
drwx — x — x 2 starship project 32 Nov 8 15 : 32 tools 

$ 

Permissions for the display and list files and the tools directory are shown on the left 
of the example under the line total 35, and appear in this format: 

-rwxr-xr-x (for the display file) 
-rw-r — r — (for the list file)) 
drwx — x (for the tools directory) 

After the initial character, which describes the file type (for example, a - (dash) sym- 
bolizes a regular file and a d a directory), the other nine characters that set the per- 
missions comprise three sets of three characters. The first set refers to permissions 
for the owner, the second set to permissions for group members, and the last set to 
permissions for all other system users. Within each set of characters, the r, w, and 
x show the permissions currently granted to each category. If a dash appears instead 
of an r, w, or x, permission to read, write, or execute is denied. 
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The following diagram summarizes this breakdown for the file named display. 



user group others 




execute 



As you can see, the owner has r, w, and x permissions and members of the group 
and other system users have r and x permissions. 

There are two exceptions to this notation system. Occasionally the letter s or the 
letter 1 may appear in the permissions line, instead of an r, w or x. The letter s 
(short for set user ID or set group ID) represents a special type of permission to exe- 
cute a file. It appears where you normally see an x (or -) for the user or group (the 
first and second sets of permissions). From a user's point of view it is equivalent to 
an x in the same position; it implies that execute permission exists. It is significant 
only for programmers and system administrators. (See the System Administrator's 
Guide for details about setting the user or group ID.) 

The letter 1 is the symbol for lock enabling. It does not mean that the file has been 
locked. It simply means that the function of locking is enabled, or possible, for this 
file. The file may or may not be locked; that cannot be determined by the presence 
or absence of the letter 1. 

How to Change Existing Permissions 

After you have determined what permissions are in effect, you can change them by 
executing the chmod command in the following format: 

chmod who+permission ftle($)<C1l> 

or 

chmod who+permission file(s)<CR> 
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The following list defines each component of this command line, 
chmod name of the program 



who 



+ or 



one of three user groups (u 9 g, or o) 
u = user 
g = group 
o = others 

instruction that grants (-f) or denies (-) permission 



permission any combination of three authorizations (r, w, and x) 
r = read 
w = write 
x = execute 

file(s) file (or directory) name(s) listed; assumed to be 

branches from your current directory, unless you use 
full pathnames. 



The chmod command will not work if you type a space(s) between who, the instruc- 
tion that gives (+) or denies (— ) permission, and the permission. 



The following examples show a few possible ways to use the chmod command. As 
the owner of display, you can read, write, and run this executable file. You can pro- 
tect the file against being accidentally changed by denying yourself write (w) permis- 
sion. To do this, type the command line: 

chmod u— w display <CR> 

After receiving the prompt, type Is -1 and press the RETURN key to verify that this 
permission has been changed, as shown in the following example. 

$ chmod u— w display<CR> 
$ ls-KCR> 

total 35 
-r-xr-xr-x 
rw-r — r — 
drwx — x — x 
$ 



1 starship 

1 starship 

2 starship 



project 9346 Nov 1 08:06 display 
project 6428 Dec 2 10:24 list 
project 32 Nov 8 15:32 tools 



As you can see, you no longer have permission to write changes into the file. You 
will not be able to change this file until you restore write permission for yourself. 

Now consider another example. Notice that permission to write into the file display 
has been denied to members of your group and other system users. However, they do 
have read permission. This means they can copy the file into their own directories 
and then make changes to it. To prevent all system users from copying this file, you 
can deny them read permission by typing: 

chmod go— r display<CR> 

The g and o stand for group members and all other system users, respectively, and 
the -r denies them permission to read or copy the file. Check the results with the 
Is —1 command. 
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$ chmod go— r display <CR> 
$ Is -1<CR> 
total 35 

twx™x— -x 1 starship project 9346 Nov 1 08 : 06 display 

rw-r — r™ • 1 starship project 6428 Dec 2 10:24 list 

drwx — x — x 2 starship project 32 Nov 8 15:32 tools 
$ 

A Note on Permissions and Directories 

You can use the chmod command to grant or deny permission for directories as well 
as files. Simply specify a directory name instead of a file name on the command line. 

However, consider the impact on various system users of changing permissions for 
directories. For example, say you grant read permission for a directory to yourself 
(u), members of your group (g), and other system users (o). Every user who has 
access to the system will be able to read the names of the files contained in that direc- 
tory by running the Is -1 command. Similarly, granting write permission allows the 
designated users to create new files in the directory and remove existing ones. Grant- 
ing permission to execute the directory allows designated users to move to that direc- 
tory (and make it their current directory) by using the cd command. 

An Alternative Method 

There are two methods by which the chmod command can be executed. The method 
described above, in which symbols such as r, w, and % are used to specify permis- 
sions, is called the symbolic method. 

An alternative method is the octal method. Its format requires you to specify permis- 
sions using three octal numbers, ranging from 0 to 7. (The octal number system is 
different from the decimal system that we typically use on a day-to-day basis.) To 
learn how to use the octal method, see the chmod(l) page in the User's Reference 
Manual. 

Figure 3-24 summarizes the syntax and capabilities of the chmod command. 
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Command Recap 


VIE 111 UC1 


UlldllgC pCillll&MUll IllUUCb 1U1 111C5 ^allU till CL- IU1 ICo^ 


command 


instruction arguments 


chmod 


who + - permission filename(s) 

directoryname(s) 


Description: 


chmod gives (4-) or removes (-) permission to 
read, write, and execute files for three 
categories of system users: user (you), group 

^iuchiuci a ul yuui giuiiLiJ, dtiiu uuicr ydii lhiici 

users able to access the system on which you 
are working). 


Remarks: 


The instruction set can be represented in 
either octal or symbolic terms. 



Figure 3-24: Summary of the chmod Command 



Advanced Commands 

Use of the commands already introduced will increase your familiarity with the file 
system. As this familiarity increases, so might your need for more sophisticated 
information processing techniques when working with files. This section introduces 
three commands that provide just that. 

diff finds differences between two files 

grep searches for a pattern in a file 

sort sorts and merges files 

For additional information about these commands refer to the User's Reference 
Manual. 

Identifying Differences Between Files: the diff Command 

The diff command locates and reports all differences between two files and tells you 
how to change the first file so that it is a duplicate of the second. The basic format 
for the command is: 

diff filel file2<CR> 

If filel and file2 are identical, the system returns a prompt to you. If they are not, the 
diff command instructs you on how to change the first file so it matches the second by 
using ed (line editor) commands. (See Chapter 5 for details about the line editor.) 
The UMIPS system flags lines in filel (to be changed) with the < (less than) symbol, 
and lines in file! (the model text) with the > (greater than) symbol. 
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For example, say you execute the diff command to identify the differences between 
the files johnson and mcdonough. The mcdonough file contains the same letter that 
is in the johnson file, with appropriate changes for a different recipient. The diff 
command will identify those changes as follows: 



3 , 6c3 , 6 

< Mr. Ron Johnson 

< Layton Printing 

< 52 Hudson Street 

< New York, N.Y. 

> Mr. J.J. McDonough 

> Ubu Press 

> 37 Chi co Place 

> Springfield, N.J. 
9c9 

< Dear Mr. Johnson: 

> Dear Mr. McDonough: 



The first line of output from diff is : 
3 , 6c3 , 6 

This means that if you want johnson to match mcdonough, you must change (c) lines 
3 through 6 in johnson to lines 3 through 6 in mcdonough. The diff command then 
displays both sets of lines. 

If you make these changes (using a text editor such as ed or vi), the johnson file will 
be identical to the sanders file. Remember, the diff command identifies differences 
between specified files. If you want to make an identical copy of a file, use the cp 
command. 

Figure 3-25 summarizes the syntax and capabilities of the diff command. 
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Command Recap 
diff - finds differences between two files 


command 


options arguments 


diff 


available* fllel ftle2 


Description: 


The diff command reports what lines are 
different in two files and what you must do to 
make the first file identical to the second. 


Remarks: 


Instructions on how to change a file to bring it 
into agreement with another file are line editor 
(ed) commands: a (append), c (change), and 
d (delete). Numbers given with a, c, or d 
show the lines to be modified. Also used are 
the symbols < (showing a line from the first 
file) and > (showing a line from the second 
file). 



See the difl(l) page in the User's Reference Manual for all available options 
and an explanation of their capabilities. 



Figure 3-25: Summary of the diff Command 



Searching a File for a Pattern: the grep Command 

You can instruct the UMIPS system to search through a file for a specific word, 
phrase, or group of characters by executing the command grep (short for globally 
search for a regular expression and print). Put simply, a regular expression is any 
pattern of characters (be it a word, a phrase, or an equation) that you specify. 

The basic format for the command line is: 

grep pattern file(s)<CR> 

For example, to locate any lines that contain the word automation in the file johnson, 
type: 

grep automation johnson<CR> 

The system responds: 

$ grep automation johnson<CR> 

and office automation software. 
$ 

The output consists of all the lines in the file johnson that contain the pattern for 
which you were searching (automation). 
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If the pattern contains multiple words or any character that conveys special meaning 
to the UMIPS system, (such as $, | , *, ?, and so on), the entire pattern must be 
enclosed in single quotes. (For an explanation of the special meaning for these and 
other characters see "Metacharacters" in Chapter 7.) For example, say you want to 
locate the lines containing the pattern office automation. Your command line 
and the system's response will read: 

$ grep 'office automation' johnson<CR> 

and office automation software. 
$ 

But what if you cannot recall which letter contained a reference to office automation; 
your letter to Mr. Johnson or the one to Mrs. Sanders? Type the following command 
line to find out: 

$ grep 'office automation' Johnson sanders<€R> 

johnson:and office automation software. 
$ 

The output tells you that the pattern office automation is found once in the 
johnson file. 

In addition to the grep command, the UMIPS system provides variations of it called 
egrep and fgrep, along with several options that enhance the searching powers of the 
command. See the grep(l), egrep(l), and fgrep(l) pages in the User's Reference 
Manual for further information about these commands. 

Figure 3-26 summarizes the syntax and capabilities of the grep command. 





Command Recap 




grep - searches a file for a pattern 


command 


options arguments 


grep 


available* pattern file(s) 


Description: 


The grep command searches through specified 
file(s) for lines containing a pattern and then 
prints the lines on which it finds the pattern. 
If you specify more than one file, the name of 
the file in which the pattern is found is also 
reported. 


Remarks: 


If the pattern you give contains multiple words 
or special characters, enclose the pattern in 
single quotes on the command line. 



* See the grep(l) page in the User's Reference Manual for all available options 
and an explanation of their capabilities. 

Figure 3-26: Summary of the grep Command 
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Sorting and Merging Files: the sort Command 

The UMIPS system provides an efficient tool called sort for sorting and merging files. 
The format for the command line is: 

sort file(s)<CR> 

This command causes lines in the specified files to be sorted and merged in the fol- 
lowing order. 

■ Lines beginning with numbers are sorted by digit and listed before lines begin- 
ning with letters. 

■ Lines beginning with upper case letters are listed before lines beginning with 
lower case letters. 

■ Lines beginning with symbols such as *, %, or @, are sorted on the basis of 
the symbol's ASCII representation. 

For example, let's say you have two files, groupl and group2, each containing a list 
of names. You want to sort each list alphabetically and then interleave the two lists 
into one. First, display the contents of the files by executing the cat command on 
each. 

$ cat groupl<CR> 

Smith, Allyn 
Jones , Barbara 
Cook, Karen 
Moore , Peter 
Wolf, Robert 
$ cat group2<CR> 
Frank, M. Jay 
Nelson, James 
West, Donna 
Hill, Charles 
Morgan, Kristine 
$ 

(Instead of printing these two files individually, you could have requested both files on 
the same command line. If you had typed cat groupl group2 and pressed the 
RETURN key, the output would have been the same.) 

Now sort and merge the contents of the two files by executing the sort command. 
The output of the sort program will be printed on the terminal screen unless you 
specify otherwise. 
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$ sort groupl group2<CR> 

Cook, Karen 
Frank, M. Jay 
Hill, Charles 
Jones , Barbara 
Moore, Peter 
Morgan, Kristine 
Nelson, James 
Smith, Allyn 
West, Donna 
Wolf, Robert 
$ 

In addition to combining simple lists as in the example, the sort command can rear- 
range lines and parts of lines (called fields) according to a number of other 
specifications you designate on the command line. The possible specifications are 
complex and beyond the scope of this text. Refer to the User's Reference Manual for 
a full description of available options. 

Figure 3-27 summarizes the syntax and capabilities of the sort command. 





Command Recap 




sort - sorts and merges files 


command 


options arguments 


sort 


available* file(s) 


Description: 


The sort command sorts and merges lines 
from a file or files you specify and displays its 
output on your terminal screen. 


Remarks: 


If no options are specified on the command 
line, lines are sorted and merged in the order 
defined by the ASCII representations of the 
characters in the lines. 



* See the sort(l) page in the User's Reference Manual for all available options 
and an explanation of their capabilities. 

Figure 3-27: Summary of the sort Command 



3-48 USER'S GUIDE 



Summary 

This chapter described the structure of the file system and presented ways to use and 
to navigate through the file system by using UMIPS system commands. The next 
chapter gives you an overview of a variety of UMIPS system capabilities: text editing, 
using the shell as a command language, communicating electronically with other sys- 
tem users, and programming and developing software. 
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Introduction 

This chapter serves as a transition between the overview that comprises the first three 
chapters and the tutorials in the following four chapters. Specifically, it provides an 
overview of the subjects covered in these tutorials: text editing, working in the shell, 
and communicating electronically. Text editing is covered in Chapter 5, "Line Editor 
Tutorial," and Chapter 6, "Screen Editor Tutorial." How to work and program in the 
shell is taught in Chapter 7, "Shell Tutorial," and methods of electronic communica- 
tion are covered in Chapter 8, "Communication Tutorial." 
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Using the file system is a way of life in a UMIPS system environment. This section 
will teach you how to create and modify files with a software tool called a text editor. 
The section begins by explaining what a text editor is and how it works. Then it intro- 
duces two types of text editors supported on the UMIPS system: the line editor, ed, 
and the screen editor, vi (short for visual editor). A comparison of the two editors is 
also included. For detailed information about ed and vi, see Chapters 5 and 6. 



What is a Text Editor? 

Whenever you revise a letter, memo, or report, you must perform one or more of the 
following tasks: insert new or additional material, delete unneeded material, tran- 
spose material (sometimes called cutting and pasting), and, finally, prepare a clean, 
corrected copy. Text editors perform these tasks at your direction, making writing 
and revising text much easier and quicker than if done by hand. 

The UMIPS system text editors, like the UMIPS system shell, are interactive pro- 
grams; they accept your commands and then perform the requested functions. From 
the shell's point of view, the editors are executable programs. 

A major difference between a text editor and the shell, however, is the set of com- 
mands that each recognizes. All the commands introduced up to this point belong to 
the shell's command set. A text editor has its own distinct set of commands that 
allow you to create, move, add, and delete text in files, as well as acquire text from 
other files. 



How Does a Text Editor Work? 

To understand how a text editor works, you need to understand the environment 
created when you use an editing program and the modes of operation understood by a 
text editor. 

Text Editing Buffers 

When you use a text editor to create a new file or modify an existing one, you first ask 
the shell to put the editor in control of your computing session. As soon as the edi- 
tor takes over, it allocates a temporary work space called the editing buffer; any infor- 
mation that you enter while editing a file is stored in this buffer where you can modify 
it. 

Because the buffer is a temporary work space, any text you enter and any changes you 
make to it are also temporary. The buffer and its contents will exist only as long as 
you are editing. If you want to save the file, you must tell the text editor to write the 
contents of the buffer into a file. The file is then stored in the computer's memory. 
If you do not, the buffer's contents will disappear when you leave the editing program. 
To prevent this from happening, the text editors send you a reminder to write your 
file if you attempt to end an editing session without doing so. 
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If you have made a critical mistake or are unhappy with the edited version, you can 
note choose to leave the editor without writing the file. By doing so, you leave the original 
t file intact; the edited copy disappears. 



Regardless of whether you are creating a new file or updating an existing one, the text 
in the buffer is organized into lines. A line of text is simply a series of characters that 
appears horizontally across the screen and is ended when you press the RETURN 
key. Occasionally, files may contain a line of text that is too long to fit on the termi- 
nal screen. Some terminals automatically display the continuation of the line on the 
next row of the screen; others do not. 

Modes of Operation 

Text editors are capable of understanding two modes of operation: command mode 
and text input mode. When you begin an editing session, you will be placed automati- 
cally in command mode. In this mode you can move around in a file, search for pat- 
terns in it, or change existing text. However, you cannot create text while you are in 
command mode. To do this you must be in text input mode. While you are in this 
mode, any characters you type are placed in the buffer as part of your text file. When 
you have finished entering text and want to run editing commands again, you must 
return to command mode. 

Because a typical editing session involves moving back and forth between these two 
modes, you may sometimes forget which mode you are working in. You may try to 
enter text while in command mode or to enter a command while in input mode. This 
is something even experienced users do from time to time. It will not take long to 
recognize your mistake and determine the solution after you complete the tutorials in 
Chapters 5 and 6. 



Line Editor 

The line editor, accessed by the ed command, is a fast, versatile program for prepar- 
ing text files. It is called a line editor because it manipulates text on a line-by-line 
basis. This means you must specify, by line number, the line containing the text you 
want to change. Then ed prints the line on the screen where you can modify it. 

This text editor provides commands with which you can change lines, print lines, read 
and write files, and enter text. In addition, you can invoke the line editor from a 
shell program; something you cannot do with the screen editor. (See Chapter 7 for 
information on basic shell programming techniques.) 

The line editor (ed)' works well on video display terminals and paper printing termi- 
nals. It will also accommodate you if you are using a slow-speed telephone line. (The 
visual editor, vi, can be used only on video display terminals.) Refer to Chapter 5, 
"Line Editor Tutorial," for instructions on how to use this editing tool. Also see 
Appendix C for a summary of line editor commands. 



OVERVIEW OF THE TUTORIALS 4-3 



Text Editing 



Screen Editor 

The screen editor, accessed by the vi command, is a display-oriented, interactive 
software tool. It allows you to view the file you are editing a page at a time. This edi- 
tor works most efficiently when used on a video display terminal operating at 1200 or 
higher baud. 

For the most part, you modify a file (by adding, deleting, or changing text) by posi- 
tioning the cursor at the point on the screen where the modification is to be made and 
then making the change. The screen editor immediately displays the results of your 
editing; you can see the change you made in the context of the surrounding text. 
Because of this feature, the screen editor is considered more sophisticated than the 
line editor. 

Furthermore, the screen editor offers a choice of commands. For example, a number 
of screen editor commands allow you to move the cursor around a file. Other com- 
mands scroll the file up or down on the screen. Still other commands allow you to 
change existing text or to create new text. In addition to its own set of commands, 
the screen editor can access line editor commands, 

The trade-off for the screen editor's speed, visual appeal, efficiency, and power is the 
load it places on the connection to your terminal. Every time you make a change, no 
matter how simple, vi must update the screen. Refer to Chapter 6, "Screen Editor 
Tutorial," for instructions on how to use this editor. Appendix D contains a summary 
of screen editor commands, and Figure 4-1 compares the features of the line editor 
(ed) and the screen editor (vi). MIPS systems are so fast that vi is not a significant 
cpu load. 
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Feature 


Line Editor (ed) 


Screen Editor (vi) 


Recommended 
terminal type 


Video display or 
paper-printing 


Video display 


Speed 


Accommodates high- 

dllU lUW-JSpCCU Udld 

transmission lines. 


Works best via high- 

bUCCLl Cld-ld. 11 all Mill oMUll 

lines (1200+ baud). 


Versatility 


Can be specified to 
run from shell scripts 
did weii ab u&eu uuriiig 
editing sessions. 


Must be used interac- 
tively during editing ses- 
sions. 


Sophistication 


Changes text quickly. 
Uses comparatively 
small amounts of pro- 
cessing time. 


Changes text easily. 
However, can make 
heavy demands on com- 
puter resources. 


Power 


Provides a full set of 
editing commands. 
Standard UMIPS sys- 
tem text editor. 


Provides its own editing 
commands and recog- 
nizes line editor com- 
mands as well. 


Advantages 


There are fewer com- 
mands you must learn 
to use ed. 


vi allows you to see the 
. effects of your editing in 
the context of a page of 
text, immediately. 
(When you use the ed 
editor, making changes 
and viewing the results 
are separate steps.) 



Figure 4-1: Comparison of Line and Screen Editors (ed and vi) 
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Every time you log in to the UMIPS system you start communicating with the shell, 
and continue to do so until you log off the system. However, while you are using a 
text editor, your interaction with the shell is suspended; it resumes as soon as you 
stop using the editor. 

The shell is much like other programs, except that instead of performing one job, as 
cat or Is does, it is central to your interactions with the UMIPS system. The shell's 
primary function is to act as a command interpreter between you and the computer 
system. As an interpreter, the shell translates your requests into language the com- 
puter understands, calls requested programs into memory, and executes them. 

This section introduces methods of using the shell that enhance your ability to use 
system features. In addition to using it to run a single program, you may also use the 
shell to: 

■ interpret the name of a file or a directory you enter in an abbreviated way using 
a type of shell shorthand 

■ redirect the flow of input and output of the programs you run 

■ execute multiple programs simultaneously or in a pipeline format 

■ tailor your computing environment to meet your individual needs 

In addition to being the command language interpreter, the shell is a programming 
language. For detailed information on how to use the shell as a command interpreter 
and a programming language, refer to Chapter 7. 

Customizing Your Computing Environment 

This section deals with another control provided by the shell: your environment. 
When you log in to the UMIPS system, the shell automatically sets up a computing 
environment for you. The default environment set up by the shell includes these vari- 
ables: 

HOME your login directory 

LOGNAME your login name 

PATH route the shell takes to search for executable files or commands 

(typically PATH=:/bin:/usr/bin) 

The PATH variable tells the shell where to look for the executable program invoked 
by a command. Therefore it is used every time you issue a command. If you have 
executable programs in more than one directory, you will want all of them to be 
searched by the shell to make sure every command can be found. 

You can use the default environment supplied by your system or you can tailor an 
environment to meet your needs. If you choose to modify any part of your environ- 
ment, you can use either of two methods to do so. If you want to change a part of 
your environment only for the duration of your current computing session, specify 
your changes in a command line (see Chapter 7 for details). However, if you want to 
use a different environment (not the default environment) regularly, you can specify 
your changes in a file that will set up the desired environment for you automatically 
every time you log in. This file must be called .profile and must be located in your 
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home directory. 

The .profile typically performs some or all of the following tasks: checks for mail; 
sets data parameters, terminal settings, and tab stops; assigns a character or character 
string as your login prompt; and assigns the erase and kill functions to keys. You can 
define as few or as many tasks as you want in your .profile. You can also change 
parts of it at any time. For instructions on modifying a .profile, see "Modifying Your 
Login Environment" in Chapter 7. 

Now check to see whether or not you have a .profile. If you are not already in your 
home directory, cd to It. Then examine your .profile by issuing this command: 

cat .profile 

If you have a .profile, its contents will appear on your screen. If you do not have a 
•profile you can create one with a text editor, such as ed or vi. (See "Modifying Your 
Login Environment" in Chapter 7 for instructions.) 



Programming in the Shell 

The shell is not only the command language interpreter; it is also a command level 
programming language. This means that instead of always using the shell strictly as a 
liaison between you and the computer, you can also program it to repeat sequences of 
instructions automatically. To do this, you must create executable files containing 
lists of commands. These files are called shell procedures or shell scripts. Once you 
have a shell script for a particular task, you can simply request that the shell read and 
execute the contents of the script whenever you want to perform that task. 

Like other programming languages, the shell provides such features as variables, con- 
trol structures, subroutines, and parameter passing. These features enable you to 
create your own tools by linking together system commands. 

For example, you can combine three UMIPS system programs (the date, who, and wc 
commands) into a simple shell script called users that tells you the current date and 
time, and how many users are working on your system. If you use the vi editor 
(described in Chapter 6) to create your script, you can follow this procedure. First, 
create the file users with the editor by typing 

vi users<CR> 

The editor will draw a blank page on your screen and wait for you to enter text. 



cursor 



"users" [New file] 



Enter the three UMIPS system commands on one line: 
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date; who | wc — 1 

Then write and quit the file. Make users executable by adding execute permission 
with the chmod command. 

chmod ug+x users<CR> 

Now try running your new command. The following screen shows the kind of output 
you will get. 



$ users<CR> 

Sat Mar 1 16:40:12 EST 1986 
4 

$ 



The output tells you that four users were logged in on the system when you typed the 
command at 16:40 on Saturday, March 1, 1986. 

For step-by-step instructions on writing shell scripts and information about more 
sophisticated shell programming techniques, see Chapter 7, "Shell Tutorial." 
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As a UMIPS system user, you can send messages or transmit information stored in 
files to other users who work on your system or another UMIPS system. To do so, 
you must be logged in on a UMIPS system that is capable of communicating with the 
UMIPS system to which you want to send information. The command you use to 
send information depends on what you are sending. This guide introduces you to 
these communication programs: 

mail This command allows you to send messages or files to other 

UMIPS system users, using their login names as addresses. It also 
allows you to receive messages sent by other users, mail holds 
messages and lets the recipient read them at his or her conveni- 
ence. 



mailx 



uucp 



uuto/uupick 



uux 



This command is a sophisticated, more powerful version of mail. 
It offers a number of options for managing the electronic mail you 
send and receive. 

This command is used to send files from one UMIPS system to 
another. (Its name is an acronym for UMIPS to UMIPS system 
copy.) You can use uucp to send a file to a directory you specify 
on a remote computer. When the file has been transferred, the 
owner of the directory is notified of its arrival by mail. 

These commands are used to send and retrieve files. You can use 
the uuto command to send a file(s) to a public directory; when it is 
available, the recipient is notified by mail that the file(s) has 
arrived. The recipient then can use the uupick command to copy 
the file(s) from the public directory to a directory of choice. 

This command lets you execute commands on a remote computer. 
It gathers files from various computers, executes the specified com- 
mand on these files, and sends the standard output to a file on the 
specified computer. 



Chapter 8 offers tutorials on each of these commands. 
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Programming in the System 

The UMIPS system provides a powerful and convenient environment for program- 
ming and software development, using the C programming language, FORTRAN-77, 
BASIC, Pascal, COBOL, PL/1, and Ada. As well, the UMIPS system provides 
some sophisticated tools designed to make software development easier and to pro- 
vide a systematic approach to programming. 

For information on the general topic of programming in the UMIPS system environ- 
ment, see the Programmer's Guide, Besides supplementing texts on programming 
languages, the Programmer's Guide provides tutorials on the following five tools: 

SCCS Source Code Control System 

make maintains programs 

lex generates programs for simple lexical tasks 

yacc generates parser programs 

RCS Revision Control System 
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Introducing the Line Editor 



This chapter is a tutorial on the line editor, ed. ed is versatile and requires little com- 
puter time to perform editing tasks. It can be used on any type of terminal. The 
examples of command lines and system responses in this chapter will apply to your 
terminal, whether it is a video display terminal or a paper printing terminal. The ed 
commands can be typed in at your terminal or they can be used in a shell program 
(see Chapter 7, "Shell Tutorial"). 

ed is a line editor; during editing sessions it is always pointing at a single line in the 
file called the current line. When you access an existing file, ed makes the last line 
the current line so you can start appending text easily. Unless you specify the number 
of a different line or range of lines, ed will perform each command you issue on the 
current line. In addition to letting you change, delete, or add text on one or more 
lines, ed allows you to add text from another file to the buffer. 

During an editing session with ed, you are altering the contents of a file in a tem- 
porary buffer, where you work until you have finished creating or correcting your text. 
When you edit an existing file, a copy of that file is placed in the buffer and your 
changes are made to this copy. The changes have no effect on the original file until 
you instruct ed, by using the write command, to move the contents of the buffer into 
the file. 

After you have read through this tutorial and tried the examples and exercises, you 
will have a good working knowledge of ed. The following basics are included: 

■ entering the line editor ed, creating text, writing the text to file, and quitting ed 

■ addressing particular lines of the file and displaying lines of text 

■ deleting text 

■ substituting new text for old text 

■ using special characters as shortcuts in search and substitute patterns 

■ moving text around in the file, as well as other useful commands and informa- 
tion 
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The commands discussed in each section are reviewed at the end of that section. A 
summary of all ed commands introduced in this chapter is found in Appendix C, 
where they are listed by topic. 

At the end of some sections, exercises are given so you can experiment with the com- 
mands. The answers to all exercises are at the end of this chapter. 

The notation- conventions used in this chapter are those used throughout this Guide. 
They are described in the Preface. 
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The best way to learn ed is to log in to the UMIPS system and try the examples as 
you read this tutorial. Do the exercises; do not be afraid to experiment. As you 
experiment and try out ed commands, you will learn a fast and versatile method of 
text editing. 

In this section you will learn the commands used to: 

■ enter ed 

■ append text 

■ move up or down in the file to display a line of text 

■ delete a line of text 

■ write the buffer to a file 

■ quit ed 



How to Enter ed 

To enter the line editor, type ed and a file name: 
ed filename<CR> 

Choose a name that reflects the contents of the file. If you are creating a new file, the 
system responds with a question mark and the file name: 

$ ed new-file<CR> 

?new-f ile 

If you going to edit an existing file, ed responds with the number of characters in the 
file: 

$ ed old-fi!e<CR> 

235 



How to Create Text 

The editor receives two types of input, editing commands and text, from your termi- 
nal. To avoid confusing them, ed recognizes two modes of editing work: command 
mode and text input mode. When you work in command mode, any characters you 
type are interpreted as commands. In input mode, any characters you type are inter- 
preted as text to be added to a file. 

Whenever you enter ed you are put into command mode. To create text in your file, 
change to input mode by typing a (for append), on a line by itself, and pressing the 
RETURN key: 

a<CR> 

Now you are in input mode; any characters you type from this point wil be added to 
your file as text. Be sure to type a on a line by itself; if you do not, the editor will not 
execute your command. 
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After you have finished entering text, type a period on a line by itself. This takes you 
out of the text input mode and returns you to the command mode. Now you can give 
ed other commands. 

The following example shows how to enter ed, create text in a new file called try-me, 
and quit text input mode with a period. 

$ ed try-me<CR> 

? try-me 
a<CR> 

This is the first line of text.<CR> 
This is the second line,<CR> 
and this is the third line.<CR> 
.<CR> 

Notice that ed does not give a response to the period; it just waits for a new com- 
mand. If ed does not respond to a command, you may have forgotten to type a 
period after entering text and may still be in text input mode. Type a period and 
press the RETURN key at the beginning of a line to return to command mode. Now 
you can execute editing commands. For example, if you have added some unwanted 
characters or lines to your text, you can delete them once you have returned to com- 
mand mode. 



How to Display Text 

To display a line of a file, type p (for print) on a line by itself. The p command 
prints the current line, that is, the last line on which you worked. Continue with the 
previous example. You have just typed a period to exit input mode. Now type the p 
command to see the current line. 

$ ed try-me<CR> 

? try-me 
a<CR> 

This is the first line of text.<CR> 
This is the second line,<CR> 
and this is the third line.<CR> 
.<CR> 
p<CR> 

and this is the third line . 

You can print any line of text by specifying its line number (also known as the address 
of the line). The address of the first line is 1; of the second, 2; and so on. For exam- 
ple, to print the second line in the file try-me, type: 

2p<CR> 

This is the second line, 

You can also use line addresses to print a span of lines by specifying the addresses of 
the first and last lines of the section you want to see, separated by a comma. For 
example, to print the first three lines of a file, type: 

l,3p<CR> 
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You can even print the whole file this way. For example, you can display a twenty- 
line file by typing l,20p. If you do not know the address of the last line in your file, 
you can substitute a $ sign, ed symbol for the address of the last line. (These conven- 
tions are discussed in detail in the section "Line Addressing.") 

l,$p<CR> 

This is the first line of text. 

This is a second line, 

and this is the third line. 

If you forget to quit text input mode with a period, you will add text that you do not 
want. Try to make this mistake. Add another line of text to your try-me file and 
then try the p command without quitting text input mode. Then quit text input mode 
and print the entire file. 

p<CR> 

and this is the third line. 
a<CR> 

This is the fourth line.<CR> 

p<CR> 

.<CR> 

l,$p<CR> 

This is the first line of text. 
This is the second line, 
and this is the third line. 
This is the fourth line. 
P 

What did you get? The next section will explain how to delete the unwanted line. 



How to Delete a Line of Text 

To delete text, you must be in the command mode of ed. Typing d deletes the 
current line. Try this command on the last example to remove the unwanted line con- 
taining p. Display the current line (p command), delete it (d command), and display 
the remaining lines in the file (p command). Your screen should look like this: 

p<CR> 

P 

d<CR> 
l,$p<CR> 

This is the first line of text. 
This is a second line, 
and this is the third line. 
This is the fourth line. 

ed does not send you any messages to confirm that you have deleted text. The only 
way you can verify that the d command has succeeded is by printing the contents of 
your file with the p command. To receive verification of your deletion, you can put 
the d and p together on one command line. If you repeat the previous example with 
this command, your screen should look like this: 
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p<CR> 

P 

dp<CR> 

This is the fourth line . 



How to Move Up or Down in the File 

To display the line below the current line, press the RETURN key while in command 
mode. If there is no line below the current line, ed responds with a ? and continues 
to treat the last line of the file as the current line. To display the line above the 
current line, press the minus key (-). 

The following example provides examples of how both of these commands are used: 
p<CR> 

This is the fourth line. 
-<CR> 

and this is the third line . 
-<CR> 

This is a second line, 
-<CR> 

This is the first line of text. 
<CR> 

This is a second line, 
<CR> 

and this is the third line . 

Notice that by typing -<CR> or <CR>, you can display a line of text without typing 
the p command. These commands are also line addresses. Whenever you type a line 
address and do not follow it with a command, ed assumes that you want to see the 
line you have specified. Experiment with these commands: create some text, delete a 
line, and display your file. 



How to Save the Buffer Contents in a File 

As we discussed earlier, during an editing session, the system holds your text in a 
temporary storage area called a buffer. When you have finished editing, you can save 
your work by writing it from the temporary buffer to a permanent file in the 
computer's memory. By writing to a file, you are simply putting a copy of the con- 
tents of the buffer into the file. The text in the buffer is not disturbed, and you can 
make further changes to it. 



NOTE 



It is a good idea to write the buffer text into your file frequently. If an interrupt 
occurs (such as an accidental loss of power to your terminal), you may lose the 
material in the buffer, but you will not lose the copy written to your file. 



To write your text to a file, enter the w command. You do not need to specify a file 
name; simply type w and press the RETURN key. If you have just created new text, 
ed creates a file for it with the name you specified when you entered the editor. If 
you have edited an existing file, the w command writes the contents of the buffer to 
that file by default. 
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If you prefer, you can specify a new name for your file as an argument on the w com- 
mand line. Be careful not to use the name of a file that already exists unless you want 
to replace its contents with the contents of the current buffer, ed will not warn you 
about an existing file; it will simply overwrite that file with your buffer contents. 

For example, if you decide you would prefer the try-me file to be called stuff, you can 
rename it: 

$ ed try-me<CR> 

? try-me 
a<CR> 

This is the first line of text.<CR> 
This is the second line,<CR> 
and this is the third line.<CR> 

w stuff <CR> 

85 

Notice the last line of the example. This is the number of characters in your text. 
When the editor reports the number of characters in this way, the write command has 
succeeded. 



How to Quit the Editor 

When you have completed editing your text, write it from the buffer into a file with 
the w command. Then leave the editor and return to the shell by typing q (for quit). 

w<CR> 

85 

q<CR> 

$ 

The system responds with. a shell prompt. At this point the editing buffer vanishes. 
If you have not executed the write command, your text in the buffer has also van- 
ished. If you did not make any changes to the text during your editing session, no 
harm is done. However, if you did make changes, you could lose your work in this 
way. Therefore, if you type q after changing the file without writing it, ed warns you 
with a ?. You then have a chance to write and quit. 

q<CR> 

? 

w<CR> 

85 

q<CR> 

$ 

If, instead of writing, you insist on typing q a second time, ed assumes you do not 
want to write the buffer's contents to your file and returns you to the shell. Your file 
is left unchanged and the contents of the buffer are wiped out. 

You now know the basic commands needed to create and edit a file using ed. Figure 
5-1 summarizes these commands. 
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Command 


Function 


ed file 


enter ed to edit file 


a 


append text after the current line 


• 


quit text input mode and return to ed com- 




mand mode. 


D 


print text on your terminal 


d 


delete text 


<CR> 


display the next line in the buffer (literally, 




carriage return) 


+ 


display the next line in the buffer 




display the previous line in the buffer 


w 


write the contents of the buffer to the file 


q 


quit ed and return to the shell 



Figure 5-1: Summary of ed Editor Commands 
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Answers for all the exercises in this chapter are found at the end of the chapter. 
However, they are not necessarily the only possible correct answers. Any method 
that enables you to perform a task specified in an exercise is correct, even if it does 
not match the answer given. 

1-1. Enter ed with a file named junk. Create a line of text containing Hello 
World, write it to the file and quit ed. 

Now use ed to create a file called stuff. Create a line of text containing two 
words, Goodbye world, write this text to the file, and quit ed. 

1-2. Enter ed again with the file named junk. What was the editor's response? 
Was the character count for it the same as the character count reported by 
the w command in Exercise 1-1? 



Display the contents of the file. Is that your file junk? 

How can you return to the shell? Try q without writing the file. Why do you 
think the editor allowed you to quit without writing to the buffer? 

1-3. Enter ed with the file junk. Add a line: 

Wendy's horse came through the window. 

Since you did not specify a line address, where do you think the line was 
added to the buffer? Display the contents of the buffer. Try quitting the 
buffer without writing to the file. Try writing the buffer to a different file 
called stuff. Notice that ed does not warn you that a file called stuff already 
exists. You have erased the contents of stuff and replaced them with new 
text. 
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ed commands have a simple and regular format: 

[addressl[,address!]]command[argument]<CR> 

The brackets around address 1, address!, and argument show that these are optional. 
The brackets are not part of the command line. 

address 1, address! 

The addresses give the position of lines in the buffer. Addressl 
through address! gives you a range of lines that will be affected 
by the command. If address! is omitted, the command will affect 
only the line specified by addressl . 

command The command is one character and tells the editor what task to 
perform. 

argument The arguments to a command are those parts of the text that will 
be modified, or a file name, or another line address. 

This format will become clearer to you when you begin to experiment with the ed 
commands. 
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A line address is a character or group of characters that identifies a line of text. 
Before ed can execute commands that add, delete, move, or change text, it must 
know the line address of the affected text. Type the line address before the com- 
mand: 

[address 1] , [address2]command<CR> 

Both address 1 and address! are optional. Specify address 1 alone to request action on 
a single line of text; both address 1 and address! to request a span of lines. If you do 
not specify any address, ed assumes that the line address is the current line. 

The most common ways to specify a line address in ed are: 

■ by entering line numbers (assuming that the lines of the files are consecutively 
numbered from 1 to n, beginning with the first line of the file) 

■ by entering special symbols for the current line, last line, or a span of lines 

■ by adding or subtracting lines from the current line 

■ by searching for a character string or word on the desired line 

You can access one line or a span of lines, or make a global search for all lines con- 
taining a specified character string. (A character string is a set of successive charac- 
ters, such as a word.) 



Numerical Addresses 

ed gives a numerical address to each line in the buffer. The first line of the buffer is 
1, the second line is 2, and so on, for each line in the buffer. Any line can be 
accessed by ed with its line address number. To see how line numbers address a line, 
enter ed with the file try-me and type a number. 

$ ed try-me<CR> 

110 

1<CR> 

This is the first line of text. 
3<CR> 

and this is the third line. 

Remember that p is the default command for a line address specified without a com- 
mand. Because you gave a line address, ed assumes you want that line displayed on 
your terminal. 

Numerical line addresses frequently change in the course of an editing session. Later 
in this chapter you will create lines, delete lines, or move a line to a different posi- 
tion. This will change the line address numbers of some lines. The number of a 
specific line is always the current position of that line in the editing buffer. For exam- 
ple, if you add five lines of text between line 5 and 6, line 6 becomes line 11. If you 
delete line 5, line 6 becomes line 5. 
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Symbolic Addresses 

Symbolic Address of the Current Line 

The current line is the line most recently acted on by any ed command. If you have 
just entered ed with an existing file, the current line is the last line of the buffer. The 
symbol for the address of the current line is a period, Therefore you can display the 
current line simply by typing a period (.) and pressing the RETURN key. 

Try this command in the file try-me: 

$ ed try-me<CR> 
110 

•<CR> 

This is the fourth line. 

The . is the address. Because a command is not specified after the period, ed exe- 
cutes the default command p and displays the line found at this address. 

To get the line number of the current line, type the following command: 

.=<CR> 

ed responds with the line number. For example, in the try-me file, the current line is 
4. 

.<CR> 

This is the fourth line. 

•=<CR> 

4 

Symbolic Address of the Last Line 

The symbolic address for the last line of a file is the $ sign. To verify that the $ sign 
accesses the last line, access the try-me file with ed and specify this address on a line 
by itself. (Keep in mind that when you first access a file, your current line is always 
the last line of the file.) 

$ ed try-me<CR> 

110 

.<CR> 

This is the fourth line . 
$<CR> 

This is the fourth line. 

Remember that the $ address within ed is not the same as the $ prompt from the 
shell. 

Symbolic Address of the Set of All Lines 

When used as an address, a comma (,) refers to all the lines of a file, from the first 
through the last line. It is an abbreviated form of the string mentioned earlier that 
represents all lines in a file, 1,$. Try this shortcut to print the contents of try-me: 
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,p<CR> 

This is the first line of text. 
This is the second line, 
and this is the third line. 
This is the fourth line. 



Symbolic Address of the Current Line through the Last Line 

The semi-colon (;) represents a set of lines beginning with the current line and ending 
with the last line of a file. It is equivalent to the symbolic address .,$. Try it with the 
file try- me: 

2p<CR> 

This is the second line, 
;p<CR> 

This is the second line, 
and this is the third line. 
This is the fourth line. 



Relative Addresses: Adding or Subtracting Lines from the Current 
Line 

You may often want to address lines with respect to the current line. You can do this 
by adding or subtracting a number of lines from the current line with a plus (+) or a 
minus (— ) sign. Addresses derived in this way are called relative addresses. To 
experiment with relative line addresses, add several more lines to your file try- me, as 
shown in the following example. Also, write the buffer contents to the file so your 
additions will be saved: 

$ ed try-me<CR> 

110 

.<CR> 

This is the fourth line. 

a<CR> 

five<CR> 

six<CR> 

seven<CR> 

eight<CR> 

nine<CR> 

ten<CR> 

.<CR> 

w<CR> 

140 

Now try adding and subtracting line numbers from the current line. 
4<CR> 

This is the fourth line. 

+3<CR> 

seven 

-5<CR> 

This is a second line, 

What happens if you ask for a line address that is greater than the last line, or if you 
try to subtract a number greater than the current line number? 
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5<CR> 

five 

~6<CR> 

? 

,=<CR> 
5 

+7<CR> 

? 

Notice that the current line remains at line 5 of the buffer. The current line changes 
only if you give ed a correct address. The ? response means there is an error. "Other 
Useful Commands and Information," at the end of this chapter, explains how to get a 
help message that describes the error. 

Character String Addresses 

You can search forward or backward in the file for a line containing a particular char- 
acter string. To do so, specify a string, preceded by a delimiter. 

Delimiters mark the boundaries of character strings; they tell ed where a string starts 
and ends. The most common delimiter is / (slash), used in the following format: 

/pattern 

When you specify a pattern preceded by a / (slash), ed begins at the current line and 
searches forward (down through subsequent lines in the buffer) for the next line con- 
taining the pattern. When the search reaches the last line of the buffer, ed wraps 
around to the beginning of the file and continues its search from line 1. 

The following rectangle represents the editing buffer. The path of the arrows shows 
the search initiated by a / : 

r i 

J . I ; i 

i first line 

| V 

j current line 

! V last line 

, 1 — ^ — ; 

i i 

Another useful delimiter is ?. If you specify a pattern preceded by a ?, (^pattern), ed 
begins at the current line and searches backward (up through previous lines in the 
buffer) for the next line containing the pattern. If the search reaches the first line of 
the file, it will wrap around and continue searching upward from the last line of the 
file. 

The following rectangle represents the editing buffer. The path of the arrows shows 
the search initiated by a ? : 
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^ first line 



current line 



last line 



Experiment with these two methods of requesting address searches on the file try-me. 
What happens if ed does not find the specified character string? 

$ ed try-me<CR> 

140 

•<CR> 

ten 

?first<CR> 
This is the 
/fourth<CR> 
This is the 
/junk<CR> 



first line of text. 



fourth line. 



In this example, ed found the specified strings first and fourth. Then, because no 
command was given with the address, it executed the p command by default, display- 
ing the lines it had found. When ed cannot find a specified string (such as junk), it 
responds with a ? . 

You can also use the / (slash) to search for multiple occurrences of a pattern without 
typing it more than once. First, specify the pattern by typing /pattern, as usual, 
After ed has printed the first occurrence, it waits for another command. Type / and 
press the RETURN key; ed will continue to search forward through the file for the 
last pattern specified. Try this command by searching for the word line in the file 
try-me: 

.<CR> 

This is the first line of text. 
/line<CR> 

This is the second line, 
/<CR> 

and this is the third line. 
/<CR> 

This is the fourth line. 
/<CR> 

This is the first line of text. 



Notice that after ed has found all occurrences of the pattern between the line where 
you requested a search and the end of the file, it wraps around to the beginning of the 
file and continues searching. 
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Specifying a Range of Lines 

There are two ways to request a group of lines. You can specify a range of lines, 
such as addressl through address!, or you can specify a global search for all lines 
containing a specified pattern. 

The simplest way to specify a range of lines is to use the line numbers of the first and 
last lines of the range, separated by a comma. Place this address before the com- 
mand. For example, if you want to display lines 2 through 7 of the editing buffer, give 
addressl as 2 and address2 as 7 in the following format: 

2,7p<CR> 

Try this on the file try-me: 

2,7p<CR> 

This is the second line, 

and this is the third line. 

This is the fourth line . 

five 

six 

seven 

Did you try typing 2,7 without the p? What happened? If you do not add the p com- 
mand, ed prints only address!, the last line of the range of addresses. 

Relative line addresses can also be used to request a range of lines. Be sure that 
addressl precedes addressl in the buffer. Relative addresses are calculated from the 
current line, as the following example shows: 

4<CR> 

This is the fourth line 
-2,+3p<CR> 

This is the second line, 

and this is the third line . 

This is the fourth line . 

five 

six 

seven 

Specifying a Global Search 

There are two commands that do not follow the general format of ed commands: g 
and v. These are global search commands that specify addresses with a character 
string (pattern). The g command searches for all lines containing the string pattern 
and performs the command on those lines. The v command searches for all lines that 
do not contain the pattern and performs the command on those lines. 

The general format for these commands is: 

g/ pattern /command<CR> 
y/ pattern/ command<CR> 

Try these commands by using them to search for the word line in try-me: 
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g/line/p<CR> 

This is the first line of text. 
This is the second line/ 
and this is the third line. 
This is the fourth line 

v/line/p<CR> 

five 

six 

seven 

eight 

nine 

ten 

Notice the function of the v command: it finds all the lines that do not contain the 
word specified in the command line (line). 

Once again, the default command for the lines addressed by g or v is p; you do not 
need to include a p as the last delimiter on your command line. 

g/line<CR> 

This is the first line of text. 
This is the second line, 
and this is the third line. 
This is the fourth line 

However, if you are giving line addresses to be used by other ed commands, you need 
to include beginning and ending delimiters. You can use any of the methods dis- 
cussed in this section to specify line addresses for ed commands. Figure 5-2 summar- 
izes the symbols and commands available for addressing lines. 
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Address 


Description 


• 


the number of a line in the buffer 

the current line (the line most recently acted on by an ed 
command) 




the command used to request the line number of the 
current line 


$ 


the last line of the file 


9 


the set of lines from line 1 through the last line 


9 


the set of lines from the current line through the last line 




the line that is located n lines after the current line 


- n 


the line that is located n lines before the current line 


/abc 


the command used to search forward in the buffer for the 
first line that contains the pattern abc 


labc 


the command used to search backward, in the buffer for 
the first line that contains the pattern abc 


g/abc 


the set of all lines that contain the pattern abc 


y/abc 


the set of all lines that do NOT contain the pattern abc 



Figure 5-2: Summary of Line Addressing 
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2-1. Create a file called towns with the following lines: 

My kind of town is 
Chicago 

Like being no where at all in 
Toledo 

I lost those little town blues in 

New York 

I lost my heart in 

San Francisco 

I lost $$ in 

Las Vegas 

2-2. Display line 3. 

2-3. If you specify a range of lines with the relative address -2,+3p, what lines are 
displayed ? 

2-4. What is the current line number? Display the current line. 
2-5. What does the last line say? 

2-6. What line is displayed by the following request for a search? 
?town<CR> 

After ed responds, type this command alone on a line: 

?<CR> 
What happened? 

2-7. Search for all lines that contain the pattern in. Then search for all lines that 
do NOT contain the pattern in. 
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ed provides two commands for displaying lines of text in the editing buffer: p and n. 

Displaying Text Alone: the p Command 

You have already used the p command in several examples. You are probably now 
familiar with its general format: 

[address l,address2]p<CR> 

p does not take arguments. However, it can be combined with a substitution com- 
mand line. This will be discussed later in this chapter. 

Experiment with the line addresses shown in Figure 5-3 on a file in your home direc- 
tory. Try the p command with each address and see if ed responds as described in 
the figure. 



Specify this Address 


Check for this Response 


1,$P<CR> 


ed should display the entire file on 
your terminal. 


-5p<CR> 


ed should move backward five lines 
from the current line and display the 
line found there. 


+2p<CR> 


ed should move forward two lines 
from the current line and display the 
line found there. 


l,/x/p<CR> 


ed displays the set of lines from line 
one through the first line after the 
current line that contains the character 
x. It is important to enclose the letter 
x between slashes so that ed can distin- 
guish between the search pattern 
address (x) and the ed command (p). 



Figure 5-3: Sample Addresses for Displaying Text 



Displaying Text with Line Addresses: the n Command 

The ri command displays text and precedes each line with its numerical line address. 
It is helpful when you are deleting, creating, or changing lines. The general command 
line format for n is the same as that for p. 

[address 1 ,address2]n< CR> 

Like p, n does not take arguments, but it can be combined with the substitute 
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command. 

Try running n on the try-me file: 

$ ed try-me<CR> 

140 

l,$n<CR> 



1 This is the first line of text. 

2 This is the second line, 

3 and this is the third line. 

4 This is the fourth line. 

5 five 

6 six 

7 seven 

8 eight 

9 nine 

10 ten 



Figure 5-3 summarizes the ed commands for displaying text. 



Command 


Function 


P 


displays specified lines of text in the editing buffer on 
your terminal 


n 


displays specified lines of text in the editing buffer with 
their numerical line addresses on your terminal 



Figure 5-4: Summary of Commands for Displaying Text 
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ed has three basic commands for creating new lines of text: 
a append text 
i insert text 
c change text 



Appending Text: the a Command 

The append command, a, allows you to add text AFTER the current line or a 
specified address in the file. You have already used this command in the "Getting 
Started" section of this chapter. The general format for the append command line is: 

[address l]si<CR> 

Specifying an address is optional. The default value of address! is the current line. 

In previous exercises, you used this command with the default address. Now try 
using different line numbers for addressl. In the following example, a new file called 
new-file is created. In the first append command line, the default address is the 
current line. In the second append command line, line 1 is specified as addressl. 
The lines are displayed with n so that you can see their numerical line addresses. 
Remember, the append mode is ended by typing a period (.) on a line by itself. 

$ ed new-file<CR> 

?new-f ile 
a<CR> 

Create some lines 
of text in 
this file, 
,<CR> 
l,$n<CR> 

1 Create some lines 

2 of text in 

3 this file. 
la<CR> 

This will be line 2<CR> 
This will be line 3<CR> 
.<CR> 
l,$n<CR> 



1 Create some lines 

2 This will be line 2 

3 This will be line 3 

4 of text in 

5 this file . 



Notice that after you append the two new lines, the line that was originally line 2 (of 
text in) becomes line 4. 

You can take shortcuts to places in the file where you want to append text by combin- 
ing the append command with symbolic addresses. The following three command 
lines allow you to move through and add to the text quickly in this way. 
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.a<CR> appends text after the current line 
$a<CR> appends text after the last line of the file 

Oa<CR> appends text before the first line of the file (at a symbolic address 
called line 0) 

To try using these addresses, create a one-line file called lines and type the examples 
shown in the following examples. (The examples appear in separately for easy refer- 
ence only; it is not necessary to access the lines file three times to try each append 
symbol. You can access lines once and try all three consecutively.) 

$ ed lines<CR> 

?lines 
a<CR> 

This is the current line.<CR> 

.<CR> 

p<CR> 

This is the current line. 
.a<CR> 

This line is after the current line.<CR> 

.<CR> 

-l,.p<CR> 

This is the current line. 

This line is after the current line. 

$a<CR> 

This is the last line now.<CR> 

.<CR> 

$<CR> 

This is the last line now. 
0a<CR> 

This is the first line now.<CR> 
This is the second line now.<CR> 
The line numbers change<CR> 
as lines are added. <CR> 
.<CR> 
l,4n<CR> 

1 This is the first line now. 

2 This is the second line now. 

3 The line numbers change 

4 as lines are added. 

Because the append command creates text after a specified address, the last example 
refers to the line before line 1 as the line after line 0. To avoid such circuitous refer- 
ences, use another command provided by the editor: the insert command, i. 



Inserting Text: the i Command 

The insert command (i), allows you to add text BEFORE a specified line in the edit- 
ing buffer. The general command line format for i is the same as that for a. 

[address 1]\<CR> 
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As with the append command, you can insert one or more lines of text. To quit 
input mode, you must type a period (.) alone on a line. 

Create a file called insert in which you can try the insert command (i): 

$ ed insert<CR> 

?insert 

a<CR> 

Line 1<CR> 

Line 2<CR> 

Line 3<CR> 

Line 4<CR> 

.<CR> 

w<CR> 

69 

Now insert one line of text above line 2 and another above line 1. Use the n com- 
mand to display all the lines in the buffer: 

2i<CR> 

This is the new line 2.<CR> 

.<CR> 

l,$n<CR> 

1 Line 1 

2 This is the new line 2 , 

3 Line 2 

4 Line 3 

5 Line 4 
li<CR> 

This is the beginning. < CR> 

.<CR> 

l,$n<CR> 

1 In the beginning 

2 Line 1 

3 Now this is line 2 

4 Line 2 

5 Line 3 

6 Line 4 

Experiment with the insert command by combining it with symbolic line addresses, as 
follows: 

■ .i<CR> 

■ $i<CR> 



Changing Text: the c Command 

The change text command (c) erases all specified lines and allows you to create one 
or more lines of text in their place. Because c can erase a range of lines, the general 
format for the command line includes two addresses. 

[address 1 ,address2]c<CR> 

The change command puts you in text input mode. To leave input mode, type a 
period alone on a line. 
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Address 1 is the first and address! is the last of the range of lines to be replaced by 
new text. To erase one line of text, specify only address 1. If no address is specified, 
ed assumes the current line is the line to be changed. 

Now create a file called change in which you can try this command. After entering 
the text shown in the example, change lines one through four by typing 1,4c: 

l,5n<CR> 

1 line 1 

2 line 2 

3 line 3 

4 line 4 

5 line 5 
l,4c<CR> 
Change line 1<CR> 

and lines 2 through 4<CR> 

.<CR> 

l,$n<CR> 

1 change line 1 

2 and lines 2 through 4 

3 line 5 

Now experiment with c and try to change the current line: 

.<CR> 

line 5 
c<CR> 

This is the new line 5. 

.<CR> 

.<CR> 

This is the new line 5 . 

If you are not sure whether you have left text input mode, it is a good idea to type 
another period. If the current line is displayed, you know you are in the command 
mode of ed. 

Figure 5-5 summarizes the ed commands for creating text. 



Command 


Function 


a 
i 
c 


append text after the specified line in the buffer 
insert text before the specified line in the buffer 
change the text on the specified line(s) to new text 
quit text input mode and return to ed command mode 



Figure 5-5: Summary of Commands for Creating Text 
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3-1. Create a new file called ex3. Instead of using the append command to create 
new text in the empty buffer, try the insert command. What happens? 

3-2. Enter ed with the file towns. What is the current line? 

Insert above the third line: 
XlIinois<CR> 

Insert above the current line: 

or<CR> 
Naperville<CR> 

Insert before the last line: 
hotels in<CR> 

Display the text in the buffer preceded by line numbers. 
3-3. In the file towns, display lines 1 through 5 and replace lines 2 through 5 with: 
London<CR> 

Display lines 1 through 3. 
3-4. After you have completed exercise 3-3, what is the current line? 

Find the line of text containing: 

Toledo 
Replace 

Toledo 

with 

Peoria 

Display the current line. 
3-5 With one command line search for and replace: 

New York 
with: 

Iron City 
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This section discusses two types of commands for deleting text in ed. One type is to 
be used when you are working in command mode: d deletes a line and u undoes the 
last command. The other type of command is to be used in text input mode: <#> 
(the pound sign) deletes a character and <@> (the at sign) kills a line. The delete 
keys that are used in input mode are the same keys you use to delete text that you 
enter after a shell prompt. They are described in detail in "Correcting Typing Errors" 
in Chapter 2. 

Deleting Lines: the d Command 

You have already deleted lines of text with the delete command (d) in the "Getting 
Started" section of this chapter. 

The general format for the d command line is: 

[address l,address2]d<CR> 

You can delete a range of lines (addressl through address!) or you can delete one line 
only {address!). If no address is specified, ed deletes the current line. 

The next example displays lines one through five and then deletes lines two through 
four: 

l,5n<CR> 

1 1 horse 

2 2 chickens 

3 3 ham tacos 

4 4 cans of mustard 

5 5 bails of hay 
2,4d<CR> 

l,$n<CR> 

1 1 horse 

2 5 bails of hay 

How can you delete only the last line of a file? Using a symbolic line address makes 
this easy: 

$d<CR> 

How can you delete the current line? One of the most common errors in ed is forget- 
ting to type a period to leave text input mode. When this happens, unwanted text 
may be added to the buffer. In the next example, a line containing a print command 
(l,$p) is accidentally added to the text before the user leaves input mode. Because 
this line was the last one added to the text, it becomes the current line. The symbolic 
address . is used to delete it. 
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a<CR> 

Last line of text<CR> 

l,$p<CR> 

.<CR> 

p<CR> 

1,$P 

.d<CR> 

p<CR> 

Last line of text." 

Before experimenting with the delete command, you may first want to learn about the 
undo command, u. 

Undoing the Previous Command: the u Command 

The command u (short for undo) nullifies the last command and restores any text 
changed or deleted by that command. It takes no addresses or arguments. The for- 
mat is: 

u<CR> 

One purpose for which the u command is useful is to restore text you have mistakenly 
deleted. If you delete all the lines in a file and then type p, ed will respond with a ? 
since there are no more lines in the file. Use the u command to restore them. 

l,$p<CR> 

This is the first line . 

This is the middle line. 

This is the last line . 

l,$d<CR> 

p<CR> 

? 

u<CR> 
p<CR> 

This is the last line. 

Now experiment with u: use it to undo the append command. 
.<CR> 

This is the only line of text 
a<CR> 

Add this line<CR> 

.<CR> 

l,$p<CR> 

This is the only line of text 

Add this line 

u<CR> 

l,$p<CR> 

This is the only line of text 
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u cannot be used to undo the write command (w) or the quit command (q). How- 
ever, u can undo an undo command (u). 



How to Delete in Text Input Mode 

While in text input mode, you can correct the current line of input with the same keys 
you use to correct a shell command line. By default, there are two keys available to 
correct text. The @ sign key kills the current line. The # sign key backs up over one 
character on the current line so you can retype it, thus effectively erasing the original 
character. (See "Correcting Typing Errors" in Chapter 2 for details.) 

As mentioned in Chapter 2, you can reassign the line kill and character erase func- 
tions to other keys if you prefer. (See "Modifying Your Login Environment" in 
Chapter 7 for instructions.) If you have reassigned these functions, you must use the 
keys you chose while working in ed; the default keys (@ and #) will no longer work. 

Escaping the Delete Function 

You may want to include an @ sign or a # sign as a character of text. To avoid hav- 
ing these characters interpreted as delete commands, you must precede them with a \ 
(backslash), as shown in the following example. 

a<CR> 

leave San Francisco \@ 20:15 on flight \#347 <CR> 

.<CR> 

p<CR> 

leave San Francisco @ 20:15 on flight #347 



Figure 5-6 summarizes the ed commands and shell commands for deleting text in ed. 



Command 


Function 


In command mode: 




<d> 


delete one or more lines of text 


<u> 


undo the previous command 


<@> 


delete the current command line 


In text input mode: 




<@> 


delete the current line 


<#> or 




<BACKSPACE> 


delete the last character typed in 



Figure 5-6: Summary of Commands for Deleting Text 
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You can modify your text with a substitute command. This command replaces the 
first occurrence of a string of characters with new text. The general command line 
format is 

[address 1 ,address2]s/old^text/new_text/[command] < CR> 

Each component of the command line is described below. 

address 1 ,address2 

The range of lines being addressed by s. The address can be one 
line, {address!), a range of lines (address 1 through address!) 9 or a 
global search address. If no address is given, ed makes the substi- 
tution on the current line. 

$ The substitute command 

loldjtext The argument specifying the text to be replaced is usually delim- 
ited by slashes, but can be delimited by other characters such as a 
? or a period. It consists of the words or characters to be 
replaced. The command will replace the first occurrence of these 
characters that it finds in the text. 

Inewjtext The argument specifying the text to replace oldjtext. It is delim- 
ited by slashes or the same delimiters used to specify the oldjtext* 
It consists of the words or characters that are to replace the 
oldjtext. 

/command Any one of the following four commands: 

g Change all occurrences of oldjtext on the specified lines. 

1 Display the last line of substituted text, including nonprinting char- 

acters. (See the last section of this chapter, "Other Useful Com- 
mands and Information.' 1 ) 

n Display the last line of the substituted text preceded by its numeri- 

cal line address. 

p Display the last line of substituted text. 



Substituting on the Current Line 

The simplest example of the substitute command is making a change to the current 
line. You do not need to give a line address for the current line. 

si oldjtext Inewjtext I < CR> 

The next example contains a typing error. While the line that contains it is still the 
current line, you make a substitution to correct it. The old text is the ai of airor and 
the new text is er. 
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a<CR> 

In the beginning, I made an airor. 

.<CR> 

.p<CR> 

In the beginning, I made an airor. 
s/ai/er<CR> 

Notice that ed gives no response to the substitute command. To verify that the com- 
mand has succeeded in this case, you either have to display the line with p or n, or 
include p or n as part of the substitute command line. In the following example, n is 
used to verify that the word file has been substituted for the word toad. 

.p<CR> 

This is a test toad 
s/toad/file/n<CR> 

1 This is a test file 

However, ed allows you one shortcut: it prints the results of the command automati- 
cally, if you omit the last delimiter after the new_Jext argument: 

.p<CR> 

This is a test file 
s/file/frog<CR> 

This is a test frog 



Substituting on One Line 

To substitute text on a line that is not the current line, include an address in the com- 
mand line, as follows: 

[address 1] s/old„text/new_text/< CR> 

For example, in the following example the command line includes an address for the 
line to be changed (line 1) because the current line is line 3: 

l,3p<CR> 

This is a pest toad 
testing testing 
come in toad 
.<CR> 

come in toad 
ls/pest/test<CR> 

This is a test toad 

As you can see, ed printed the new line automatically after the change was made, 
because the last delimiter was omitted. 



Substituting on a Range of Lines 

You can make a substitution on a range of lines by specifying the first address 
(address 1) through the last address (address!). 

[address 1 ,address2] s/old_text/new_text/<CR> 
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If ed does not find the pattern to be replaced on a line, no changes are made to that 
line. 

In the following example, all the lines in the file are addressed for the substitute com- 
mand. However, only the lines that contain the string es (the oldjtext argument) are 
changed. 

l,$p<CR> 

This is a test toad 

testing testing 

come in toad 

testing 1, 2, 3 

l,$s/es/ES/n<CR> 

4 tESting 1, 2, 3 

When you specify a range of lines and include p or n at the end of the substitute line, 
only the last line changed is printed. 

To display all the lines in which text was changed, use the n or p command with the 
address 1,$. 

l,$n<CR> 



1 This is a tESt toad 

.2 tESting testing 

3 come in toad 

4 tESting 1, 2, 3 



Notice that only the first occurrence of es (on line 2) has been changed. To change 
every occurrence of a pattern, use the g command, described in the next section. 



Global Substitution 

One of the most versatile tools in ed is global substitution. By placing the g com- 
mand after the last delimiter on the substitute command line, you can change every 
occurrence of a pattern on the specified lines. Try changing every occurrence of the 
string es in the last example. If you are following along, doing the examples as you 
read this, remember you can use u to undo the last substitute command. 

u<CR> 
l,$p<CR> 

This is a test toad 
testing, testing 
come in toad 
testing 1, 2 , 3 
l,$s/es/ES/g<CR> 
l,$p<CR> 

This is a tESt toad 
tESting tESting 
come in toad 
tESting 1,2,3 

Another method is to use a global search pattern as an address instead of the range of 
lines specified by 1,$. 
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l,$p<CR> 

This is a test toad 
testing testing 
come in toad 
testing 1, 2, 3 
g/test/s/es/ES/g<CR> 
l,$p<CR> 

This is a tESt toad 
tESting tESting 
come in toad 
tESting 1, 2, 3 

If the global search pattern is unique and matches the argument oldjtext (text to be 
replaced), you can use an ed shortcut: specify the pattern once as the global search 
address and do not repeat it as an oldjtext argument, ed will remember the pattern 
from the search address and use it again as the pattern to be replaced. 

g/old„text/s//new_text/g<CR> 

Whenever you use this shortcut, be sure to include two slashes (//) after the s. 



l,$p<CR> 

This is a test toad 
testing testing 
come in toad 
testing 1, 2, 3 
g/es/s//ES/g<CR> 
l,$p<CR> 
This is a tESt toad 
tESting tESting 
come in toad 
tESting 1, 2, 3 

Experiment with other search pattern addresses: 

fpattern<CR> 
?pattem<CR> 
y/pattern<CR> 

See what they do when combined with the substitute command. In the following 
example, the \Ipattern search format is used to locate lines that do not contain the 
pattern testing. Then the substitute command (s) is used to replace the existing pat- 
tern (in) with a new pattern (out) on those lines. 

v/testing/s/in/out<CR> 

This is a test toad 
come out toad 

Notice that the line This is a test toad was also printed, even though no substitu- 
tion was made on it. When the last delimiter is omitted, all lines found with the 
search address are printed, regardless of whether or not substitutions have been made 
on them. 
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Now search for lines that do contain the pattern testing with the g command. 

g/testing/s//jumping<CR> 

jumping testing 
jumping 1, 2, 3 

Notice that this command makes substitutions only for the first occurrence of the pat- 
tern (testing) in each line. Once again, the lines are displayed on your terminal 
because the last delimiter has been omitted. 
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4-1. In your file towns change town to city on all lines but the line with little 
town on it. 

The file should read: 

My kind of city is 
London 

Like being no where at all in 
Peoria 

I lost those little town blues in 

Iron City 

I lost my heart in 

San Francisco 

I lost $$ in 

hotels in 

Las Vegas 

4-2. Try using ? as a delimiter. Change the current line 

Las Vegas 

to 

Toledo 

Because you are changing the whole line, you can also do this by using the 
change command, c. 

4-3. Try searching backward in the file for the word 
lost 
and substitute 
found 

using the ? as the delimiter. Did it work? 
4-4. Search forward in the file for 

no 

and substitute 
NO 

for it. What happens if you try to use ? as a delimiter? 

Experiment with the various command combinations available for addressing a range 
of lines and doing global searches. 
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What happens if you try to substitute something for the $$ ? Try to substitute Big $ 

for $ on line 9 of your file. Type: ^ 

9s/$/Big $<CR> 

What happened? 



( 
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c 



Special Characters 



If you try to substitute the $ sign in the line 

I lost my $ in Las Vegas 

you will find that instead of replacing the $, the new text is placed at the end of the 
line. The $ is a special character in ed that is symbolic for the end of the line. 

ed has several special characters that give you a shorthand for search patterns and 
substitution patterns. The characters act as wild cards. If you have tried to type in 
any of these characters, the result was probably different than what you had expected. 

The special characters are: 

Match any one character. 

* Match zero or more occurrences of the preceding charac- 

ter. 

.* Match zero or more occurrences of any character follow- 

ing the period. 

Match the beginning of the line. 
$ Match the end of the line. 

\ Take away the special meaning of the special character 

that follows. 

& Repeat the old text to be replaced in the new text of the 

replacement pattern. 

[...] Match the first occurrence of a character in the brackets. 

["...] Match the first occurrence of a character that is NOT in 
the brackets. 



In the following example, ed searches for any three-character sequence ending in the 
pattern at. 

l,$p<CR> 

rat 
cat 

turtle 

cow 

goat 

g/.at<CR> 

rat 
cat 
goat 

Notice that the word goat is included because the string oat matches the string .at. 
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The * (asterisk) represents zero or more occurrences of a specified character in a 
search or substitute pattern. This can be useful in deleting repeated occurrences of a 
character that have been inserted by mistake. For example, suppose you hold down 
the R key too long while typing the word broke. You can use the * to delete every 
unnecessary R with one substitution command. 

p<CR> 
brrroke 
s/for*/for<CR> 
broke 

Notice that the substitution pattern includes the b before the first r. If the b were 
not included in the search pattern, the * would interpret it, during the search, as a 
zero occurrence of r, make the substitution on it, and quit. (Remember, only the first 
occurrence of a pattern is changed in a substitution, unless you request a global 
search with g.) The following example shows how the substitution would be made if 
you did not specify both the b and the r before the *. 

p<CR> 
brrroke 
s/r*/r<CR> 
rbrrroke 

If you combine the period and the *, the combination will match all characters. With 
this combination you can replace all characters in the last part of a line: 

p<CR> 

Toads are slimy, cold creatures 
s/are.*/are wonderful and warm<CR> 
Toads are wonderful and warm 

The .* can also replace all characters between two patterns. 
p<CR> 

Toads are slimy, cold creatures 
s/are.*cre/are wonderful and warm cre<CR> 
Toads are wonderful and warm creatures 

If you want to insert a word at the beginning of a line, use the A (circumflex) for the 
old text to be substituted. This is very helpful when you want to insert the same pat- 
tern in the front of several lines. The next example places the word all at the begin- 
ning of each line: 

l,$p<CR> 

creatures great and small 
things wise and wonderful 
things bright and beautiful 
l,$s/Vall /<CR> 
l,$p<CR> 

all creatures great and small 
all things wise and wonderful 
all things bright and beautiful 
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The $ sign is useful for adding characters at the end of a line or a range of lines: 

l,$p<CR> 

I love 
I need 
I use 

The IRS wants my 
l,$s/$/ money.<CR> 
l,$p<CR> 

I love money. 

I need money. 

I use money. 

The IRS wants my money. 

In these examples, you must remember to put a space after the word all or before 
the word money because ed adds the specified characters to the very beginning or the 
very end of the sentence. If you forget to leave a space before the word money, your 
file will look like this: 

l,$s/$/money/<CR> 
l,$p<CR> 

I lovemoney 
I needmoney 
I usemoney 

The IRS wants mymoney 
The $ sign also provides a handy way to add punctuation to the end of a line: 

l,$p<CR> 

I love money 
I need money 
I use money 

The IRS wants my money 

l,$s/$/./<CR> 

l,$p/<CR> 

I love money. 

I need money. 

I use money. 

The IRS wants my money. 

Because . is not matching a character (old text), but replacing a character (new text), 
it does not have a special meaning. To change a period in the middle of a line, you 
must take away the special meaning of the period in the old text. To do this, simply 
precede the period with a backslash (\). This is how you take away the special mean- 
ing of some special characters that you want to treat as normal text characters in 
search or substitute arguments. For instance, the following example shows how to 
take away the special meaning of the period: 

p<CR> 

Way to go. Wow! 
s/\./!<CR> 

Way to go! Wow! 
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The same method can be used with the backslash character itself. If you want to 
treat a \ as a normal text character, be sure to precede it with a \. For example, if 
you want to replace the \ symbol with the word backslash, use the substitute com- 
mand line shown in the following example: 

l,2p<CR> 

This chapter explains 

how to use the \. 

s/\\/backslash<CR> 

how to use the backslash. 

If you want to add text without changing the rest of the line, the & provides a useful 
shortcut. The & (ampersand) repeats the old text in the replacement pattern, so you 
do not have to type the pattern twice. For example: 

p<CR> 

The neanderthal skeletal remains 

s/thal/& man's/<CR> 

p<CR> 

The neanderthal man' s skeletal remains 

ed automatically remembers the last string of characters in a search pattern or the old 
text in a substitution. However, you must prompt ed to repeat the replacement char- 
acters in a substitution with the % sign. The % sign allows you to make the same 
substitution on multiple lines without requesting a global substitution. For example, 
to change the word money to the word gold, repeat the last substitution from line 1 
on line 3, but not on line 4. 

l,$n<CR> 

1 I love money 

2 I need food 

3 I use money 

4 The IRS wants my money 
ls/money/gold<CR> 

I love gold 
3s//%<CR> 
I use gold 
l,$n<CR> 

1 I love gold 

2 I need food 

3 I use gold 

4 The IRS wants my money 

ed automatically remembers the word money (the old text to be replaced), so that 
string does not have to be repeated between the first two delimiters. The % sign tells 
ed to use the last replacement pattern, gold. 

ed tries to match the first occurrence of one of the characters enclosed in brackets 
and substitute the specified old text with new text. The brackets can be at any posi- 
tion in the pattern to be replaced. 

In the following example, ed changes the first occurrence of the numbers 6, 1 , 
8, or 9 to 4 on each line in which it finds one of those numbers: 
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l,$p<CR> 

Monday 33,000 

Tuesday 75,000 

Wednesday 88,000 

Thursday 62,000 
l,$s/[6789]/4<CR> 

Monday 33,000 

Tuesday 45,000 

Wednesday 4 8,000 

Thursday 42,000 



The next example deletes the Mr or Ms from a list of names: 
l,$p<CR> 

Mr Arthur Middleton 

Mr Matt Lewis 

Ms Anna Kelley 

Ms M. L. Hodel 

l,$s/M[rs] //<CR> 

l,$p<CR> 

Arthur Middleton 

Matt Lewis 

Anna Kelley 

M. L. Hodel 

If a " (circumflex) is the first character in brackets, ed interprets it as an instruction to 
match characters that are NOT within the brackets. However, if the circumflex is in 
any other position within the brackets, ed interprets it literally, as a circumflex. 

l,$p<CR> 

grade A Computer Science 

grade B Robot Design 

grade A Boolean Algebra 

grade D Jogging 

grade C Tennis 
l,$s/grade fAB] /grade A<CR> 
l,$p<CR> 

grade A Computer Science 

grade B Robot Design 

grade A Boolean Algebra 

grade A Jogging 

grade A Tennis 



Whenever you use special characters as wild cards in the text to be changed, 
remember to use a unique pattern of characters. In the above example, if you had 
used only 

l,$s/fAB]/A<CR> 

you would have changed the g in the word grade to A. Try it. 

Experiment with these special characters. Find out what happens (or does not hap- 
pen) if you use them in different combinations. 
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Figure 5-7 summarizes the special characters for search or substitute patterns. 



Command 


Function 




Match any one character in a search or substitute pat- 
tern. 


* 


Match zero or more occurrences of the preceding char- 
acter in a search or substitute pattern. 




Match zero or more occurrences of any characters fol- 
lowing the period. 

Match the beginning of the line in the substitute pattern 
to be replaced or in a search pattern. 


$ 


Match the end of the line in the substitute pattern to be 
replaced. 


\ 


Take away the special meaning of the special character 
that follows in the substitute or search pattern. 


& 

% 


Repeat the old text to be replaced in the new text 
replacement pattern. 

Match the last replacement pattern. 


[...] 


Match the first occurrence of a character in the brack- 
ets. 


r...] 


Match the first occurrence of a character that is NOT in 
the brackets. 



Figure 5-7: Summary of Special Characters 
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Exercise 5 



5-1. 



Create a file that contains the following lines of text. 



A 
D 
C 



Computer Science 

Jogging 

Tennis 



What happens if you try this command line: 

l,$s/rAB]/A/<CR> 

Undo the above command. How can you make the C and D unique? (Hint: 
they are at the beginning of the line, in the position shown by the A .) Do not 
be afraid to experiment! 

5-2. Insert the following line above line 2: 

These are not really my grades. 

Using brackets and the * character, create a search pattern that you can use to 
locate the line you inserted. There are several ways to address a line. When 
you edit text, use the way that is quickest and easiest for you. 

5-3. Add the following lines to your file: 

I love money 
I need money 
The IRS wants my money 

Now use one command to change them to: 

It's my money 
It's my money 
The IRS wants my money 

Using two command lines, do the following: change the word on the first line 
from money to gold, and change the last two lines from money to gold 
without using the words money or gold themselves. 

5-4. How can you change the line 



10202031020 

without repeating the old digits in the replacement pattern? 
5-5. Create a line of text containing the following characters. 

* . \ & % * * 

Substitute a letter for each character. Do you need to use a backslash for 
every substitution? 



1020231020 



to 
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You have now learned to address lines, create and delete text, and make substitu- 
tions, ed has one more set of versatile and important commands. You can move, 
copy, or join lines of text in the editing buffer. You can also read in text from a file 
that is not in the editing buffer, or write lines of the file in the buffer to another file in 
the current directory. The commands that move text are: 



m move lines of text 

t copy lines of text 

j join contiguous lines of text 

w write lines of text to a file 

r read in the contents of a file 



Move Lines of Text 

The m command allows you to move blocks of text to another place in the file. The 
general format is: 

[address 1 ,address2]m[address3] < CR> 

The components of this command line include: 

address l,address2 

The range of lines to be moved. If only one line is moved, only 
addressl is given. If no address is given, the current line is moved. 

m The move command. 

addressS Place the text after this line. 

Try the following example to see how the command works. Create a file that contains 
these three lines of text: 

I want to move this line. 
I want the first line 
below this line. 

Type: 

lm3<CR> 
ed will move line 1 below line 3. 



I want to move this line. 



I want the first line 

below this line. 

I want to move this line. 
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The next example shows how this will appear on your terminal: 
l,$p<CR> 

I want to move this line. 
I want the first line 
below this line. 
lm3<CR> 
l,$p<CR> 

I want the first line 

below this line. 

I want to move this line. 



If you want to move a paragraph of text, have addressl and address! define the range 
of lines of the paragraph. 

In the following example, a block of text (lines 8 through 12) is moved below line 65. 
Notice the n command that prints the line numbers of the file: 

8,12n<CR> 

8 This is line 8. 

9 It is the beginning of a 

10 very short paragraph. 

11 This paragraph ends 

12 on this line. 
64,65n<CR> 

64 Move the block of text 

65 below this line. 
8,12m65<CR> 
59,65n<CR> 

59 Move the block of text 

60 below this line. 

61 This is line 8. 

62 It is the beginning of a 

63 very short paragraph. 

64 This paragraph ends 

65 on this line. 

How can you move lines above the first line of the file? Try the following command. 
3,4mO<CR> 

When addressS is 0, the lines are placed at the beginning of the file. 



Copy Lines of Text 

The copy command t (transfer) acts like the m command except that the block of text 
is not deleted at the original address of the line. A copy of that block of text is 
placed after a specified line of text. The general format of the command line is also 
similar. 

The general format of the t command also looks like the m command. 
[addressl ,address2]t[address3] < CR> 
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address 1 9 address2 

The range of lines to be copied. If only one line is copied, only 
addressl is given. If no address is given, the current line is copied. 

t The copy command. 

address 3 Place the copy of the text after this line. 

The next example shows how to copy three lines of text below the last line. 

Safety procedures : 

If there is a fire in the building: 

Close the door of the room to seal off the fire 



Break glass of nearest alarm. 
Pull lever . 

Locate and use fire extinguisher . 



A chemical fire in the lab requires that you : 



Break glass of nearest alarm 
Pull lever 

Locate and use fire extinguisher 



The commands and ed's responses to them are displayed in the next example. Again, 
the n command displays the line numbers: 

5,8n<CR> 

5 Close the door of the room, to seal off the fire. 

6 Break glass of nearest alarm. 

7 Pull lever . 

8 Locate and use fire extinguisher. 
30n<CR> 

30 A chemical fire in the lab requires that you: 

6,8t30<CR> 

30,$n<CR> 

30 A chemical fire in the lab requires that you : 

31 Break glass of nearest alarm 

32 Pull lever 

33 Locate and use fire extinguisher 
6,8n<CR> 

6 Break glass of nearest alarm 

7 Pull lever 

8 Locate and use fire extinguisher 



The text in lines 6 through 8 remains in place. A copy of those three lines is placed 
after line 50. 
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Experiment with m and t on one of your files. 



Joining Contiguous Lines 

The j command joins the current line with the following line. The general format is: 
[address 1, address 1]$ < CR> 

The next example shows how to join several lines together, An easy way of doing this 
is to display the lines you want to join using p or n. 

l,2p<CR> 

Now is the time to join 

the team. 

p<CR> 

the team. 

lp<CR> 

Now is the time to join 

j<CR> 

p<CR> 

Now is the time to jointhe team. 

Notice that there is no space between the. last word (join) and the first word of the 
next line (the), and the last word (play). You must place a space between them by 
using the s command. 



Write Lines of Text to a File 

The w command writes text from the buffer into a file. The general format is: 
[address l 9 address2]w [filename]<CR> 

address l 9 address2 

The range of lines to be placed in another file. If you do not use 
addressl or address! 9 the entire file is written into a new file. 

w The write command. 

filename The name of the new file that contains a copy of the block of text. 

In the following example the body of a letter is saved in a file called memo, so that it 
can be sent to other people. 

l,$n<CR> 



1 March 17, 1986 

2 Dear Kelly, 

3 There will be a meeting in the 

4 green room at 4:30 P.M. today. 

5 Refreshments will be served. 



3 9 6w memo<CR> 
87 
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The w command places a copy of lines three through six into a new file called memo, 
ed responds with the number of characters in the new file. 



Problems 

The w command overwrites preexisting files; it erases the current file and puts the 
new block of text in the file without warning you. If, in our example, a file called 
memo had existed before we wrote our new file to that name, the original file would 
have been erased. 

In "Special Commands," later in this chapter, you will learn how to execute shell com- 
mands from ed. Then you can list the file names in the directory to make sure that 
you are not overwriting a file. 

Another potential problem is that you cannot write other lines to the file memo. If 
you try to add lines 13 through 16, the existing lines (3 through 6) will be erased and 
the file will contain only the new lines (13 through 16). 

Read in the Contents of a File 

The r command can be used to append text from a file to the buffer. The general for- 
mat for the read command is: 

[address l]r filename<CR> 

addressl The text will be placed after the line address 1. If addressl is not 
given, the file is added to the end of the buffer. 

r The read command. 

filename The name of the file that will be copied into the editing buffer. 

Using the example from the write command, the next example shows a file being 
edited and new text being read into it. 



l,$n<CR> 

1 March 17, 1986 

2 Dear Michael, 

3 Are you free later today? 

4 Hope to see you there. 
3r memo<CR> 

87 

3,$n<CR> 

3 Are you free later today? 

4 There is a meeting in the 

5 green room at 4 : 30 P.M. today . 

6 Refreshments will be served. 

7 Hope to see you there . 



ed responds to the read command with the number of characters in the file being 
added to the buffer (in the example, memo). 
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It is a good idea to display new or changed lines of text to be sure that they are 
correct. 

Figure 5-8 summarizes the ed commands for moving text. 



Command 


Function 


m 


move lines of text 


t 


copy lines of text 


J 


join contiguous lines 


w 


write text into a new file 


r 


read in text from another file 



Figure 5-8: Summary of ed Commands for Moving Text 
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Exercise 6 



6-1. There are two ways to copy lines of text in the buffer: by issuing the copy 

command; or by using the write and read commands to first write text to a file 
and then read the file into the buffer. 

Writing to a file and then reading the file into the buffer is a longer process. 
Can you think of an example where this method would be more practical? 

What commands can you use to copy lines 10 through 17 of file exer into the 
file exer6 at line 7? 

6-2. Lines 33 through 46 give an example that you want placed after line 3, and not 
after line 32. What command performs this task? 

6-3. Say you are on line 10 of a file and you want to join lines 13 and 14. What 
commands can you issue to do this? 
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There are four other commands and a special file that will be useful to you during 
editing sessions. 

h ? H access the help commands, which provide error messages 

1 display characters that are not normally displayed 

f display the current file name 

! temporarily escape ed to execute a shell command 

ed.hup When a system interrupt occurs, the ed buffer is saved in a special file 
named ed.hup. 



Help Commands 

You may have noticed when you were editing a file that ed responds to some of your 
commands with a ? . The ? is a diagnostic message issued by ed when it has found 
an error. The help commands give you a short message to explain the reason for the 
most recent diagnostic. 

There are two help commands: 

h Display a short error message that explains the reason for the most recent ?. 

H Place ed into help mode so that a short error message is displayed every time 
the ? appears. (To cancel this request, type H.) 

You know that if you try to quit ed without writing the changes in the buffer to a file, 
you will get a ?. Do this now. When the ? appears, type h: 

q<CR> 

? 

h<CR> 

"warning: expecting y w' 

The ? is also displayed when you specify a new file name on the ed command line. 
Give ed a new file name. When the ? appears, type h to find out what the error mes- 
sage means. 

ed newfile<CR> 

? newfile 
h<CR> 

cannot open input file 

This message means one of two things: either there is no file called newfile or there is 
such a file but ed is not allowed to read it. 

As explained earlier, the H command responds to the ? and then turns on the help 
mode of ed, so that ed gives you a diagnostic explanation every time the ? is 
displayed subsequently. To turn off help mode, type H again. The next example 
shows H being used to turn on help mode. Sample error messages are also displayed 
in response to some common mistakes: 
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$ ed newfi!e<CR> 
e newfile<CR> 
?newf ile 
H<CR> 

cannot open input file 
/heUo<CR> 

? 

illegal suffix 
l,22p<CR> 

? 

line out of range 
a<CR> 

I am appending this line to the buffer. 
&.<CR> 

s/$ tea party<CR> 

? 

illegal or missing delimiter 
,$s/$/ tea party<CR> 

unknown command 

H<CR> 

q<CR> 

? 

h<CR> 

warning : expecting 'w' 

These are some of the most common error messages that you may encounter during 
editing sessions: 

illegal suffix 

ed cannot find an occurrence of the search pattern hello because the buffer is 
empty, 

line out of range 

ed cannot print any lines because the buffer is empty or the line specified is 
not in the buffer. 

A line of text is appended to the buffer to show you some error messages associated 
with the s command. 

illegal or missing delimiter 

The delimiter between the old text to be replaced and the new text is missing. 

unknown oowimand 

addressl was not typed in before the comma; ed does not recognize ,$. 

Help mode is then turned off and h is used to determine the meaning of the last ? . 
While you are learning ed, you may want to leave help mode turned on. If so, use the 
H command. However, once you become adept at using ed, you will only need to see 
error messages occasionally. Then you can use the h command. 
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Display Nonprinting Characters 

If you are typing a tab character, the terminal will normally display up to eight spaces 
(covering the space up to the next tab setting. (Your tab setting may be more or less 
than eight spaces. See Chapter 7, "Shell Tutorial," on setting using stty). 

If you want to see how many tabs you have inserted into your text, use the 1 (list) 
command. The general format for the 1 command is the same as for n and p. 

[address 1 ,address2]\<CR> 

The components of this command line are: 

address l,address2 The range of lines to be displayed. If no address is given, the 
current line will be displayed. If only addressl is given, only 
that line will be displayed. 

1 The command that displays the nonprinting characters along 

with the text. 

The 1 command denotes tabs with a > (greater than) character. To type control char- 
acters, hold down the CONTROL key and press the appropriate alphabetic key. The 
key that sounds the bell is "g (control-g). It is displayed as \07 which is the octal 
representation (the computer's code) for A g. 

Type in two lines of text that contain a <Tg> (control-g) and a tab. Then use the 1 
command to display the lines of text on your terminal. 

a<CR> 

Add a <~g> (control-g) to this line.<CR> 
Add a <tab> (tab) to this line.<CR> 
.<CR> 
1,21<CR> 

Add a \07 (control-g) to this line.<CR> 
Add a > (tab) to this line.<CR> 

Did the bell sound when you typed <"g>? 



The Current File Name 

In a long editing session, you may forget the file name. The f command will remind 
you which file is currently in the buffer. Or, you may want to preserve the original file 
that you entered into the editing buffer and write the contents of the buffer to a new 
file. In a long editing session, you may forget, and accidentally overwrite the original 
file with the customary w and q command sequence. You can prevent this by telling 
the editor to associate the contents of the buffer with a new file name while you are in 
the middle of the editing session. This is done with the f command and a new file 
name. 

The format for displaying the current file name is f alone on a line: 
f<CR> 

To see how f works, enter ed with a file. For example, if your file is called oldfile, ed 
will respond as shown in the following example: 
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edi oldfile<CR> 

323 

f<CR> 
oldfile 

To associate the contents of the editing buffer with a new file name use this general 
format: 

f newfile<CR> 

If no file name is specified with the write command, ed remembers the file name given 
at the beginning of the editing session and writes to that file. If you do not want to 
overwrite the original file, you must either use a new file name with the write com- 
mand, or change the current file name using the f command followed by the new file 
name. Because you can use f at any point in an editing session, you can change the 
file name immediately, You can then continue with the editing session without worry- 
ing about overwriting the original file. 

The next example shows the commands for entering the editor with oldfile and then 
changing its name to newfile. A line of text is added to the buffer and then the write 
and quit commands are issued. 

ed oldfile<CR> 

323 

f<CR> 

oldfile 

fnewfile<CR> 

newfile 

a<CR> 

Add Si line of text.<CR> 

•<CR> 

w<CR> 

343 

q<CR> 

Once you have returned to the shell, you can list your files and verify the existence of 
the new file, newfile. newfile should contain a copy of the contents of oldfile plus the 
new line of text. 



Escape to the Shell 

How can you make sure you are not overwriting an existing file when you write the 
contents of the editor to a new file name? You need to return to the shell to list your 
files. The ! allows you to temporarily return to the shell, execute a shell command, 
and then return to the current line of the editor. 

The general format for the escape sequence is: 

Ishell command line<CR> 

shell response to the command line 
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When you type the ! as the first character on a line, the shell command must follow 
on that same line. The program's response to your command will appear as the com- 
mand is running. When the command has finished executing, the ! will be appear 
alone on a line. This means that that you are back in the editor at the current line. 

For example, if you want to return to the shell to find out the correct date, type ! and 
the shell command date. 

p<CR> 

This is the current line 
! date<CR> 

Tue Apr 1 14 i 24: 22 EST 1986 
j 

p<CR> 

This is the current line. 

The example first displays the current line. Then the command is given to tem- 
porarily leave the editor and display the date. After the date is displayed, you are 
returned to the current line of the editor. 

If you want to execute more than one command on the shell command line, see the 
discussion on ; in the section called "Special Characters" in Chapter 7. 

Recovering From System Interrupts 

What happens if you are creating text in ed and there is an interrupt to the system, 
you are accidentally hung up on the system, or your terminal is unplugged? When an 
interrupt occurs, the UMIPS system tries to save the contents of the editing buffer in 
a special file named ed.hup. Later you can retrieve your text from this file in one of 
two ways. First, you can use a shell command to move ed.hup to another file name, 
such as the name the file had while you were editing it (before the interrupt). 
Second, you can enter ed and use the f command to rename the contents of the 
buffer. An example of the second method is shown in the following example 4 : 

ed ed.hup<CR> 

928 

f myfile<CR> 

myf ile 

If you use the second method to recover the contents of the buffer, be sure to remove 
the ed.hup file afterward. 



Conclusion 

You now are familiar with many useful commands in ed. The commands that were 
not discussed in this tutorial, such as G, P, Q and the use of ( ) and { }, are dis- 
cussed on the ed(l) page of the User's Reference Manual You can experiment with 
these commands and try them to see what tasks they perform. 

Figure 5-9 summarizes the functions of the commands introduced in this section. 
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Command 


Function 


h 


Display a short error message for the preceding 
diagnostic ?. 


H 


Turn on help mode. An error message will be 
given with each diagnostic ?. The second H turns 

nff Vt pin mnHp 

Ull 11 C 1 LI 111VUC'* 


1 


Display nonprinting characters in the text. 


f 


Display the current file name. 


f newfile 


Change the current file name associated with the 
editing buffer to newfile. 


kmd 


Temporarily escape to the shell to execute a shell 
command cmd. 


id. hup 


The editing buffer is saved in ed.hup if the termi- 
nal is hung up before a write command. 



Figure 5-9: Summary of Other Useful Commands 
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7-1. Create a new file called newfilel. Access ed and change the file's name to 

currentl. Then create some text and write and quit ed. Run the Is command 
to verify that there is not a file called newfilel in jour directory. If you do the 
shell command Is, you will see the directory does not contain a file called 
newfilel. 

7-2. Create a file named filel. Append some lines of text to the file. Leave 

append mode but do not write the file. Turn off your terminal. Then turn on 
your terminal and log in again. Issue the Is command in the shell. Is there a 
new file called ed.hup? Place ed.hup in ed. How can you change the current 
file name to filel? Display the contents of the file. Are the lines the same 
lines you created before you turned off your terminal? 

7-3. While you are in ed, temporarily escape to the shell and send a mail message 
to yourself. 
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Exercise 1 



$ edjunk<CR> 
? junk 
a<CR> 

Hello world.<CR> 

.<CR> 

w<CR> 

12 

q<CR> 

$ 



$ ed junk<CR> 

12 

l,$p<CR> 

Hello world.<CR> 

q<CR> 

$ 

The system did not respond with the warning question mark because you did not 
make any changes to the buffer. 



$ ed junk<CR> 

12 

a<CR> 

Wendy's horse came through the window.<CR> 
<CR> 
l,$p<CR> 

Hello world . 

Wendy's horse came through the window. 
q<CR> 

? 

w stuff<CR> 

60 

q<CR> 

$ 
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Exercise 2 

2-1. 

$ ed towns<CR> 
? towns 
a<CR> 

My kind of town is<CR> 
Chicago<CR> 

Like being no where at all in<CR> 
Toledo<CR> 

I lost those little town blues in<CR> 

New York<CR> 

I lost my heart in<CR> 

San Francisco<CR> 

I lost $$ in<CR> 

Las Vegas<CR> 

.<CR> 

w<CR> 

164 

2-2. 

3<CR> 

Like being no where at all in 

2-3. 

-2,+3p<CR> 

My kind of town is 
Chicago 

Like being no where at all in 
Toledo 

I lost those little town blues in 
New York 

2-4. 

.=<CR> 

6 

6<CR> 

New York 

2-5. 

$<CR> 

Las Vegas 

2-6. 

?town<CR> 

I lost those little town blues in 
?<CR> 

My kind of town is 
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g/in<CR> 

JMy kind of town is 

Like being no where at ail in 

I lost those little town blues in 

I lost my heart in 

1 lost $$ in 

v/in<CR> 

Chicago 

Toledo 

New York 

San Francisco 

Las Vegas 



Exercise 3 

3-1. 

$ ed ex3<CR> 

?ex3 

i<CR> 

? 

q<CR> 

The ? after the i means there is an error in the command. There is no current line 
before which text can be inserted. 
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$ ed towns<CR> 

164 

.n<CR> 

10 Las Vegas 

3i<CR> 

Illinois<CR> 

.<CR> 

.i<CR> 

or<CR> 

Naperville<CR> 

•<CR> 

$i<CR> 

hotels in<CR> 

l,$n<CR> 



3-3. 



1 


my kind of town is 




2 


Chicago 




3 


or 




4 


Naperville 




5 


Illinois 




6 


Like being no where 


at all in 


7 


Toledo 




8 


I lost those little 


town blues in 


9 


New York 




10 


I lost my heart in 




11 


San Francisco 




12 


I lost $$ in 




13 


hotels in 




14 


Las Vegas 




l,5n<CR> 




1 


My kind of town is 




2 


Chicago 




3 


or 




4 


Naperville 




5 


Illinois 





2,5c<CR> 
London<CR> 
.<CR> 
l,3n<CR> 

1 My kind of town is 

2 London 

3 Like being no where at all 
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3-4. 

XCR> 

Like being no where at all 

/Tol<CR> 

Toledo 

c<CR> 

Peoria<CR> 

.<CR> 

•<CR> 

Peoria 

3- 5. 

.<CR> 

/New Y/c<CR> 
Iron City<CR> 
•<CR> 
.<CR> 
Iron City 

Your search string need not be the entire word or line. It only needs to be unique. 

Exercise 4 

4- 1. 

v/little town/s/town/city<CR> 

My kind of city is 
London 

Like being no where at all in 

Peoria 

Iron City 

I lost my heart in 

San Francisco 

I lost $$ in 

hotels in 

Las Vegas 



The line 



I lost those little town blues in 
was not printed because it was NOT addressed by the v command, 
4-2. 

.<CR> 

Las Vegas 

s?Las Vegas?Toledo<CR> 

Toledo 
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4-3. 

?lost?s??found<CR> 

I found $$ in 

4- 4. 

/no?s??NO<CR> 

? 

/no/s//NO<CR> 

Like being NO where at all in 
You cannot mix delimiters such as / and ? in a command line. 
The substitution command on line 9 produced this output: 

I found $$ inBig $ 
It did not work correctly because the $ sign is a special character in ed. 

Exercise 5 

5- 1. 

$ ed filel<CR> 

? filel 
a<CR> 

A Computer Science<CR> 
D Jogging<CR> 
C Tennis<CR> 
.<CR> 

l,$s/fAB]/A/<CR> 
l,$p<CR> 

A Computer Science 
A Jogging 
A Tennis 
u<CR> 

l,$s/TAB]/A<CR> 
1,$P<CR> 

A Computer Science 
A Jogging 
A Tennis 

5-2. 

2i<CR> 

These are not really my grades. <CR> 
l,$p<CR> 

A Computer Science 

These are not really my grades. 

A Tennis 

A Jogging 

/TA]<CR> 

These are not really my grades 
?~[T]<CR> 

These are not really my grades 
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5-3. 

1, $p<CR> 

I love money 

I need money 

The IRS wants my money 

gri/s/I,*m /It's* my m<CR> 

It' s my money 

It' s my money 

/s/money/gold<CR> 

It's my gold 

2, $s//%<CR> 

The IRS wants my gold 

5-4. 

s/10202/&0<CR> 

10202031020 

5-5, 

a<CR> 

* , \ & % * *<CR> 

,<CR> 

s/*/a<CR> 

a . \ & % " * 

s/*/b<CR> 

a , \ & % " b 

Because there were no preceding characters, * substituted for itself. 

s/\./c<CR> 

a c \ & % ~ b 

s/ \\/d<CR> 

a c d $ % b 

$/&/e<CR> 

a c d e % ^ b 

s/%/f<CR> 

a c d e f ~ b 

The & and % are only special characters in the replacement text, 

s/V/g<CR> 

a c d e f g b 



Exercise 6 

6-1. Any time you have lines of text that you may want to have repeated several 
times, it may be easier to write those lines to a file and read in the file at 
those points in the text. 

If you want to copy the lines into another file you must write them to a file 
and then read that file into the buffer containing the other file. 
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ed exer<CR> 

725 

10,17 w temp<CR> 

210 

q<CR> 

ed exer6<CR> 

305 

7r temp<CR> 

210 



The file temp can be called any file name. 
6-2. 

33,46m3<CR> 

6-3. 

.=<CR> 

10 

13p<CR> 

This is line 13 . 

j<CR> 

•p<CR> 

This is line 13 . and line 14. 
Remember that .= gives you the current line. 



Exercise 7 

7-1. 

$ ed newfilel<CR> 
? newfilel 
f currentl<CR> 
currentl 
a<CR> 

This is a line of text<CR> 

Will it go into newfilel<CR> 

or into currentl<CR> 

.<CR> 

w<CR> 

66 

q<CR> 
$ ls<CR> 

bin 

currentl 
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ed filel<CR> 

? filel 
a<CR> 

I am adding text to this fi!e.<CR> 
Will it show up in ed.hup?<CR> 
•<CR> 

Turn off your terminal. 

Log in again. 

ed ed.hup<CR> 

58 

f filel<CR> 

filel 

l,$p<CR> 

I am adding text to this file 
Will it show up in ed. hup? 



$ edfllel<CR> 

58 

! mail mylogin<CR> 
You will get mail when<CR> 
you are done editing! <CR> 
.<CR> 
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Introduction 



This chapter is a tutorial on the screen editor, vi (short for visual editor). The vi edi- 
tor is a powerful and sophisticated tool for creating and editing files. It is designed 
for use with a video display terminal which is used as a window through which you 
can view the text of a file. A few simple commands allow you to make changes to the 
text that are quickly reflected on the screen. 

The vi editor displays from one to many lines of text. It allows you to move the cur- 
sor to any point on the screen or in the file (by specifying places such as the beginning 
or end of a word, line, sentence, paragraph, or file) and create, change, or delete text 
from that point. You can also use some line editor commands, such as the powerful 
global commands that allow you to change multiple occurrences of the same character 
string by issuing one command. To move through the file, you can scroll the text for- 
ward or backward, revealing the lines below or above the current window, as shown 
in Figure 6-1. 



NOTE 



Not all terminals have text scrolling capability; whether or not you can take advantage 
of vi's scrolling feature depends on what type of terminal you have. 
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TEXT FILE 
You are in the screen editor. 

This part of the file is above 
the display window. You can 
place it on the screen by 
scrolling backward. 



This part of the file 

is in the display window. 

You can edit it. 



This part of the file is below 
the display window. You can 
place it on the screen by 
scrolling forward. 



Figure 6-1: Displaying a File with a vi Window 



There are more than 100 commands within vi. This chapter covers the basic com- 
mands that will enable you to use vi simply but effectively. Specifically, it explains 
how to do the following tasks: 

■ set up your terminal so that vi is accessible 

■ enter vi, create text, delete mistakes, write the text to a file, and quit 

■ move text within a file 

■ electronically cut and paste text 

■ use special commands and shortcuts 

■ temporarily escape to the shell to execute shell commands 

■ use line editing commands available within vi 
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■ edit several files in the same session 

■ recover a file lost by an interruption to an editing session 

■ change your shell environment to set your terminal configuration and an 
automatic carriage return 



Suggestions for Reading this Tutorial 

As you read this tutorial, keep in mind the notation conventions described in the Pre- 
face. In the examples in this chapter arrows are also used to show the position of the 
cursor. 

The commands discussed in each section are reviewed at the end of the section. A 
summary of vi commands is found in Appendix D, where they are listed by topic. At 
the end of some sections, exercises are given so you can experiment. The answers to 
all the exercises are at the end of this chapter. The best way to learn vi is by doing 
the examples and exercises as you read the tutorial. Log in on the UMIPS system 
when you are ready to read this chapter. 
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The UMIPS system is flexible; it can run on many types of computers and can be 
accessed from many kinds of terminals. However, because it is internally structured 
to be able to operate in so many ways, it needs to know what kind of hardware is 
being used in a given situation. 

In addition, the UMIPS system offers various optional features for using your terminal 
that you may or may not want to incorporate into your computing session routine. 
Your choice of these options, together with your hardware specifications, comprise 
your login environment. Once you have set up your login environment, the shell 
implements these specifications and options automatically every time you log in. 

This section describes two parts of the login environment: setting the terminal 
configuration, which is essential for using vi properly, and setting the wrapmargin, or 
automatic (carriage) RETURN, which is optional. 



Setting the Terminal Configuration 

Before you enter vi, you must set your terminal configuration. This simply means that 
you tell the UMIPS system what type of terminal you are using. This is necessary 
because the software for the vi editor is executed differently on different terminals. 

Each type of terminal has several code names that are recognized by the UMIPS sys- 
tem. Appendix F, "Setting Up the Terminal," tells you how to find a recognized name 
for your terminal. Keep in mind that many computer installations add terminal types 
to the list of terminals supported by default in your UMIPS system. It is a good idea 
to check with your local system administrator for the most up-to-date list of available 
terminal types. 

To set your terminal configuration, type 

TERM=terminaLname<CR> 
export TERM<CR> 
tput init<CR> 

The first line puts a value (a terminal type) in a variable called TERM. The second 
line exports this value; it conveys the value to all UMIPS system programs whose exe- 
cution depends on the type of terminal being used. 

The tput command on the third line initializes (sets up) the software in your terminal 
so that it functions properly with the UMIPS system. It is essential to run the tput 
init command when you are setting your terminal configuration because terminal func- 
tions such as tab settings will not work properly unless you do. 

For example, if your terminal is a Teletype 5425 this is how your commands will 
appear on the screen. 

$ TERM=5425<CR> 
$ export TERM<CR> 
$ tput init<CR> 

Do not experiment by entering names for terminal types other than your terminal. 
This might confuse the UMIPS system, and you may have to log off, hang up, or get 
help from your system administrator to restore your login environment. 
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Changing Your Environment 

If you are going to use vi regularly, you should change your login environment per- 
manently so you do not have to configure your terminal each time you log in. Your 
login environment is controlled by a file in your home directory called .profile. (This 
file, pronounced dot profile, does not exist in the file system; you must create it. For 
details, see Chapter 7.) 

If you specify the setting for your terminal configuration in your .profile, your termi- 
nal will be configured automatically every time you log in. You can do this by adding 
the three lines shown in the last example (the TERM assignment, export command, 
and tput command) to your .profile. (For detailed instructions, see Chapter 7.) 



Setting the Automatic RETURN 



NOTE 



To set an automatic RETURN you must know how to create a file. If you are fami- 
liar with another text editor, such as ed, follow the instructions in this section. If you 
do not know how to use an editor but would like to have an automatic RETURN set- 
ting, skip this section for now and return to it when you have learned the basic skills 
taught in this chapter. 



If you want the RETURN key to be entered automatically, create a file called .exrc in 
your home directory. You can use the .exrc file to contain options that control the vi 
editing environment. (For details about the .exrc file, see the Editing Guide or Edit- 
ing Utilities Guide.) 

To create a .exrc file, enter an editor with that file name. Then type in one line of 
text: a specification for the wrapmargin (automatic carriage return) option. The for- 
mat for this option specification is 

wm=n<CR> 

n represents the number of characters from the righthand side of the screen where 
you want an automatic carriage return to occur. For example, say you want a carriage 
return at twenty characters from the righthand side of the screen. Type 

wm=20<CR> 

Finally, write the buffer contents to the file and quit the editor (see "Text Editing 
Buffers" in Chapter 4). The next time you log in, this file will give you an automatic 
RETURN. 

To check your settings for the terminal and wrapmargin when you are in vi, enter the 
command 

:set<CR> 

vi will report the terminal type and the wrapmargin, as well as any other options you 
may have specified. You can also use the :set command to create or change the 
wrapmargin option. Try experimenting with it. 
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Creating a File 

First, enter the editor; type vi and the name of the file you want to create or edit, 
vl filename<CR> 

For example, say you want to create a file called stuff. When you type the vi com- 
mand with the file name stuff, vi clears the screen and displays a window in which you 
can enter and edit text. 



"stuff" [New file] 

The _ (underscore) on the top line shows the cursor waiting for you to enter a com- 
mand there. (On video display terminals the cursor may be a blinking underscore or 
a reverse color block.) Every other line is marked with a ~ (tilde), the symbol for an 
empty line. 

If, before entering vi, you have forgotten to set your terminal configuration or have 
set it to the wrong type of terminal, you will see an error message instead. 

$ vi stuff<CR> 

terminaljname: unknown terminal type 

[Using open mode ] 
"stuff" [New file] 

You cannot set the terminal configuration while you are in the editor; you must be in 
the shell. Leave the editor by typing 

s q<CR> 

Then set the correct terminal configuration. 



How to Create Text: the Append Mode 

If you have successfully entered vi, you are in command mode and vi is waiting for 
your commands. How do you create text? 

■ Press the A key (<a>) to enter the append mode of vi. (Do not press the 
RETURN key.) You can now add text to the file. (An A is not printed on the 
screen.) 

■ Type in some text. 

■ To begin a new line, press the RETURN key. 

If you have specified the wrapmargin option in a .exrc file, you will get a new 
line whenever you get an automatic RETURN (see "Setting the Automatic 
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RETURN"). 



How to Leave Append Mode 

When you finish creating text, press the ESCAPE key to leave append mode and 
return to command mode. Then you can edit any text you have created or write the 
text in the buffer to a file. 

<a>Create some text<CR> 
in the screen editor<CR> 
and return to<CR> 
command mode.<ESC> 



If you press the ESCAPE key and a bell sounds, you are already in command mode. 
The text in the file is not affected by this, even if you press the ESCAPE key several 
times. 
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To edit an existing file you must be able to add, change, and delete text. However, 
before you can perform those tasks you must be able to move to the part of the file 
you want to edit, vi offers an array of commands for moving from page to page, 
between lines, and between specified points inside a line. These commands, along 
with commands for deleting and adding text, are introduced in this section. 



How to Move the Cursor 

To edit your text, you need to move the cursor to the point on the screen where you 
will begin the correction. This is easily done with four keys that are grouped together 
on the keyboard: h, j, k, and 1. 

<h> moves the cursor one character to the left 

<j> moves the cursor down one line 

<k> moves the cursor up one line 

<1> moves the cursor one character to the right 

The <j> and <k> commands maintain the column position of the cursor. For exam- 
ple, if the cursor is on the seventh character from the left, when you type <j> or 
<k> it goes to the seventh character on the new line. If there is no seventh character 
on the new line, the cursor moves to the last character. 

Many people who use vi find it helpful to mark these four keys with arrows showing 
the direction in which each key moves the cursor. 

Some terminals have special cursor control keys that are marked with arrows. Use 
note them in the same way you use the <h>, <j>, <k>, and <1> commands. 

~ I 

Watch the cursor on the screen while you press the keys <h>, <j>, <k>, and <1>. 
Instead of pressing a motion command key a number of times to move the cursor a 
corresponding number of spaces or lines, you can precede the command with the 
desired number. For example, to move two spaces to the right, you can press <1> 
twice or enter <21>. To move up four lines, press <k> four times or enter <4k>. 
If you cannot go any farther in the direction you have requested, vi will sound a bell. 

Now experiment with the j and k motion commands. First, move the cursor up seven 
lines. Type 

<7k> 

The cursor will move up seven lines above the current line. If there are less than 
seven lines above the current line, a bell will sound and the cursor will remain on the 
current line. 

Now move the cursor down thirty-five lines. Type 
<35j> 

vi will clear and redraw the screen. The cursor will be on the thirty-fifth line below 
the current line, appearing in the middle of the new window. If there are less than 
thirty-five lines below the current line, the bell will sound and the cursor will remain 
on the current line. Watch what happens when you type the next command. 
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<35k> 

Like most vi commands, the <h>, <j>, <k>, and <1> motion commands are 
silent; they do not appear on the screen as you enter them. The only time you should 
see characters on the screen is when you are in append mode and are adding text to 
your file. If the motion command letters appear on the screen, you are still in append 
mode. Press the ESCAPE key to return to command mode and try the commands 
again. 



Moving the Cursor to the Right or Left 

In addition to the motion command keys <h> and <1>, the space bar and the 
BACKSPACE key can be used to move the cursor right or left to a character on the 
current line. 

< space bar> move the cursor one character to the right 

</ispace bar> move the cursor n characters to the right 
<BACKSPACE> move the cursor one character to the left 
<rtBACKSPACE> move the cursor n characters to the left 

Try typing in a number before the command key. Notice that the cursor moves the 
specified number of characters to the left or right. In the example below, the cursor 
movement is shown by the arrows. 

To move the cursor quickly to the right or left, prefix a number to the command. For 
example, suppose you want to create four columns in your screen. After you've 
finished typing the headings for the first three columns, you notice a typing mistake. 

Column 1 Column 2 column 



<ESC> 

You want to correct your mistake before continuing. Exit insert mode and return to 
command mode by pressing the ESCAPE key; the cursor will move to the n. Then 
use the <h> command to move back five spaces. 

Column 1 Column 2 column 



<5h> 

Column 1 Column 2 column 



<x><i>C<ESC> 

Erase the c by typing <x>. Then change to insert mode (<i>), enter a C, followed 
by pressing the ESCAPE key. Use the <1> motion command to return to your ear- 
lier position. 
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Column 1 Column 2 



Column 



<51> 

Column 1 Column 2 Column 



By now you may have discovered that you can move the cursor back and forth on a 
line by using the space bar and the BACKSPACE key. 

< space bar> move the cursor one character to the right 

<ftspace bar> move the cursor n characters to the right 

<BACKSPACE> move the cursor one character to the left 

</zBACKSPACE> move the cursor n characters to the left 

Again, you can specify a multiple space movement by typing a number before press- 
ing the space bar or BACKSPACE key. The cursor will move the number of charac- 
ters you request to the left or right. 



How to Delete Text 

If you want to delete a character, move the cursor to that character and press the 
<x>. Watch the screen as you do so; the character will disappear and the line will 
readjust to the change. To erase three characters in a row, press <x> three times. 
In the following example, the arrows under the letters show the positions of the cur- 
sor. 

<x> delete one character 

<n\> delete n characters, where n is the number of characters you 

want to delete 



Hello wurld! 



<x> 



Hello wrld! 



Now try preceding <x> with the number of characters you want to delete. For exam- 
ple, delete the second occurrence of the word deep from the text shown in the fol- 
lowing example. Put the cursor on the first letter of the string you want to delete, and 
delete five characters (for the four letters of deep plus an extra space). 
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Tomorrow the Loch Ness monster 

shall slither forth from 

the deep dark deep depths of the lake. 



<5x> 



Tomorrow the Loch Ness monster 

shall slither forth from 

the deep dark depths of the lake. 



<5x> 



Notice that vi adjusts the text so that no gap appears in place of the deleted string. 
If, as in this case, the string you want to delete happens to be a word, you can also 
use the vi command for deleting a word. This command is described later in the sec- 
tion "Word Positioning." 



How to Add Text 

There are two basic commands for adding text: the insert (<i>) and append (<a>) 
commands. To add text with the insert command at a point in your file that is visible 
on the screen, move the cursor to that point by using <h>, <j>, <k>, and <1>. 
Then press <i> and start entering text. As you type, the new text will appear on the 
screen to the left of the character on which you put the cursor. That character and 
all characters to the right of the cursor will move right to make room for your new 
text. The vi editor will continue to accept the characters you type until you press the 
ESCAPE key. If necessary, the original characters will even wrap around onto the 
next line. 

Hello Wrld! 



<i>o 

Hello World! 



<ESC> 

You can use the append command in the same way. The only difference is that the 
new text will appear to the right of the character on which you put the cursor. 

Later in this tutorial you will learn how to move around on the screen or scroll 
through a file to add or delete characters, words, or lines. 



SCREEN EDITOR TUTORIAL (vi) 6-1 1 



Quitting vi 



When you have finished your text, you will want to write the buffer contents to a file 
and return to the shell. To do this, hold down the SHIFT key and press Z twice 
(<ZZ>). The editor remembers the file name you specified with the vi command at 
the beginning of the editing session, and moves the buffer text to the file of that 
name. A notice at the bottom of the screen gives the file name and the number of 
lines and characters in the file. Then the shell gives you a prompt. 

<a>This is a test ffle.<CR> 

I am adding text to<CR> 

a temporary buffer and<CR> 

now it is perfect.<CR> 

I want to write this fi!e,<CR> 

and return to the shell.<ESCXZZ> 



"stuff" [New file] 7 lines , 151 characters 
$ 

You can also use the sw and :q commands of the line editor for writing and quitting a 
file, (Line editor commands begin with a colon and appear on the bottom line of the 
screen.) The sw command writes the buffer to a file. The sq command leaves the 
editor and returns you to the shell. You can type these commands separately or com- 
bine them into the single command :wq. It is easier to combine them. 

<a>This is a test file.<CR> 
I am adding text to<CR> 
a temporary buffer and<CR> 
now it is perfect.<CR> 
I want to write this file ? <CR> 
and return to the shelI.<ESC> 



:wq<CR> 
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Figure 6-2 summarizes the basic commands you need to enter and use vi. 



Command 


Function 


JEBM^terminaLname 
export TERM 


set the terminal configuration 


tput init 


initialize the terminal as defined by terminaljname 


vi filename 


enter vi editor to edit the file called filename 


<a> 


add text after the cursor 


<h> 


move one character to the left 


<j> 


move down one line 


<k> 


move up one line 




move one character to the right 


^X^ 


delete a character 


stK> 


carriage return 


<ESC> 


leave append mode, and return to vi 
command mode 


:w 


write to a file 




quit vi 


swq 


write to a file and quit vi 


<ZZ> 


write to a file and quit vi 
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Answers to the exercises are given at the end of this chapter. However, keep in mind 
that there is often more than one way to perform a task in vi. If your method works, 
it is correct. 

As you give commands in the following exercises, watch the screen to see how it 
changes or how the cursor moves. 

1-1. If you have not logged in yet, do so now. Then set your terminal 
configuration. 

1-2. Enter vi and append the following five lines of text to a new file called exerl. 

This is an exercise! 
Up, down, 
left, right, 

build your terminal's 
muscles bit by bit 

1-3. Move the cursor to the first line of the file and the seventh character from the 
right. Notice that as you move up the file, the cursor moves in to the last 
letter of the file, but it does not move out to the last letter of the next line. 

1-4. Delete the seventh and eighth characters from the right. 

1-5. Move the cursor to the last character on the last line of the text. 

1-6. Append the following new line of text: 

and byte by byte 
1-7. Write the buffer to a file and quit vi. 

1-8. Reenter vi and append two more lines of text to the file exerl. 

What does the notice at the bottom of the screen say once you have reentered 
vi to edit exerl? 
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Until now you have been moving the cursor with the <h>, <j>, <k>, <I>, BACK- 
SPACE key, and the space bar. There are several other commands that can help you 
move the cursor quickly around the screen. This section explains how to position the 
cursor in the following ways: 

■ by characters on a line 

■ by lines 

■ by text objects 

□ words 

□ sentences 

□ paragraphs 

■ in the window 

There are also commands that position the cursor within parts of the vi editing buffer 
that are not visible on the screen. These commands will be discussed in the next sec- 
tion, "Positioning the Cursor in Undisplayed Text." 

To follow this section of the tutorial, you should enter vi with a file that contains at 
least forty lines. If you do not have a file of that length, create one now. Remember, 
to execute the commands described here, you must be in command mode of vi. Press 
the ESCAPE key to make sure that you are in command mode rather than append 
mode. 



Positioning the Cursor on a Character 

There are three ways to position the cursor on a character in a line. 

■ by moving the cursor right or left to a character 

■ by specifying the character at either end of the line 

■ by searching for a character on a line 

The first method was discussed earlier in this chapter under "Moving the Cursor to 
the Right or Left." The following sections describe the other two methods. 

Moving the Cursor to the Beginning or End of a Line 

The second method of positioning the cursor on a line is by using one of three com- 
mands that put the cursor on the first or last character of a line. 

<$> puts the cursor on the last character of a line 

<0> (zero) puts the cursor on the first character of a line 

<"> (circumflex) puts the cursor on the first nonblank character of a line 

The following examples show the movement of the cursor produced by each of these 
three commands. 
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Go to the end of the line! 



<$> 

Go to the end of the line! 



Go to the beginning of the line! 



<0> 

Go to the beginning of the line! 



Go to the first character 
of the line 

that is not blank! 



O 

Go to the first character 
of the line 

that is not blank! 



Searching for a Character on a Line 

The third way to position the cursor on a line is to search for a specific character on 
the current line, If the character is not found on the current line, a bell sounds and 
the cursor does* not move. (There is also a command that searches a file for patterns. 
This will be discussed in the next section,) There are six commands you can use to 
search within a line: <f>, <F>, <t>, <T>, <;>, and <,>. You must specify a 
character after all of them except the <;> and < 5 > commands. 

<£*> Move the cursor to the right to the specified character x. 

<¥x> Move the cursor to the left to the specified character x. 

<tx> Move the cursor right to the character just before the specified character 
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<Tx> Move the cursor left to the character just after the specified character x. 

<;> Continue the search specified in the last command, in the same direction. 
The ; remembers the character and seeks out the next occurrence of that 
character on the current line. 

<,> Continue the search specified in the last command, in the opposite direc- 
tion. The , remembers the character and seeks out the previous 
occurrence of that character on the current line. 

For example, in the following example vi searches to the right for the first occurrence 
of the letter A on the current line. 

Go forward to the letter A on this line. 



<fA> 

Go forward to the letter A on this line. 



Try the search commands on one of your files. 



Line Positioning 

Besides the <j> and <k> commands that you have already used, the <+>, <->, 
and <CR> commands can be used to move the cursor to other lines. 

The Minus Sign Motion Command 

The <-> command moves the cursor up a line, positioning it at the first nonblank 
character on the line. To move more than one line at a time, specify the number of 
lines you want to move before the <-> command. For example, to move the cursor 
up thirteen lines, type: 

<13-> 

The cursor will move up thirteen lines. If some of those lines are above the current 
window, the window will scroll up to reveal them. This is a rapid way to move 
quickly up a file. 

Now try to move up 100 lines. Type: 
<100-> 

What happened to the window? If there are less then 100 lines above the current line 
a bell will sound, telling you that you have made a mistake, and the cursor will remain 
on the current line. 

The Plus Sign Motion Command 

The plus sign command (<+>) or the <CR> command moves the cursor down a 
line. Specify the number of lines you want to move before the <+> command. For 
example, to move the cursor down nine lines, type: 

<9+> 
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The cursor will move down nine lines. If some of those lines are below the current 
screen, the window will scroll down to reveal them. 

Now try to do the same thing by pressing the RETURN key. Were the results the 
same as when you pressed the + key? 



Word Positioning 

The vi editor considers a word to be a string of characters that may include letters, 
numbers, or underscores. There are six word positioning commands: <w>, <b>, 
<e>, <W>, <B>, and <E>. The lower case commands (<w>, <b>, and <e>) 
treat any character other than a letter, digit, or underscore as a delimiter, signifying 
the beginning or end of a word. Punctuation before or after a blank is considered a 
word. The beginning or end of a line is also a delimiter. 

The upper case commands (<W>, <B>, and <E>) treat punctuation as part of the 
word; words are delimited by blanks and newlines only. 

The following is a summary of the word positioning commands. 

<w> Move the cursor forward to the first character in the next word. You may 
press <w> as many times as you want to reach the word you want, or you 
can prefix the necessary number to the <w>. 

<nw> Move the cursor forward n number of words to the first character of that 
word. The end of the line does not stop the movement of the cursor; 
instead, the cursor wraps around and continues counting words from the 
beginning of the next line. 

The <w> command 

leaps word by word through the 

file . Move from THIS word forward 



<6w> 

six words to THIS word. 

The <w> command 
leaps word by word through the 
file. Move from THIS word forward 
six words to THIS word. 



<W> Ignore all punctuation and move the cursor forward to the word after the 
next blank. 

<e> Moves the cursor forward in the line to the last character in the next 
word. 
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Go forward one word to the end of 
the next word in this line 

<e> 

Go forward one word to the end of 
the next word in this line 

Go to the end of the third word after the current word. 
<3e> 

Go to the end of the third word after the current word. 



<E> Ignores all punctuation except blanks, delimiting words only by blanks. 

<b> Move the cursor backward in the line to the first character of the previous 
word. 

<nb> Move the cursor backward n number of words to the first character of the 
nth word. The <b> command does not stop at the beginning of a line, 
but moves to the end of the line above and continues moving backward. 

<B> Can be used just like the <b> command, except that it delimits the word 
only by blank spaces and newlines. It treats all other punctuation as 
letters of a word. 

Leap backward word by word through 
the file. Go back four words from here. 



<4b> 

the file. Go back four "words from here. 
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Positioning the Cursor by Sentences 

The vi editor also recognizes sentences. In vi a sentence ends in ! or . or ? . If 
these delimiters appear in the middle of a line, they must be followed by two blanks 
for vi to recognize them. You should get used to the vi convention of recognizing two 
blanks after a period as the end of a sentence, because it is often useful to be able to 
operate on a sentence as a unit. 

You can move the cursor from sentence to sentence in the file with the <(> (open 
parenthesis) and <)> (close parenthesis) commands. 

< ( > Move the cursor to the beginning of the current sentence. 

< n(> Move the cursor to the beginning of the nth sentence above the current 

sentence. 

< ) > Move the cursor to the beginning of the next sentence. 

< ri) > Move the cursor to the beginning of the /ith sentence below the current 

sentence. 

The example in the following examples shows how the open parenthesis moves the 
cursor around the screen. 

Suddenly we spotted whales in the 

distance . Daniel was the first to see them. 



<(> 



distance . Daniel was the first to see them. 



Now repeat the command, preceding it with a number. For example, type: 

<3(> (or) 
<5)> 



Did the cursor move the correct number of sentences? 



Positioning the Cursor by Paragraphs 

Paragraphs are recognized by vi if they begin after a blank line. If you want to be 
able to move the cursor to the beginning of a paragraph (or later in this tutorial, to 
delete or change a whole paragraph), then make sure each paragraph ends in a blank 
line. 
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<{> Move the cursor to the beginning of the current paragraph, which 

is delimited by a blank line above it. 

<n{> Move the cursor to the beginning of the nth paragraph above the 

current paragraph. 

<}> Move the cursor to the beginning of the next paragraph. 

<n}> Move the cursor to the nth paragraph below the current line. 

The following two examples show how the cursor can be moved to the beginning of 
another paragraph. 

Suddenly, we spotted whales in the 
distance. Daniel was the first to see them. 



<}> 

"Hey look! Here come the whales!" he cried excitedly. 



Suddenly, we spotted whales in the 



distance. Daniel was the first to see them. 

"Hey look! Here come the whales!" he cried excitedly. 

Positioning in the Window 

The vi editor also provides three commands that help you position yourself in the win- 
dow. Try out each command. Be sure to type them in upper case. 

<H> Move the cursor to the first line on the screen. 

<M> Move the cursor to the middle line on the screen. 

<L> Move the cursor to the last line on the screen. 
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This part of the file is 
above the display window. 



r. 



Type <H> (HOME) to move the cursor here. 



Type <M> (MIDDLE) to move the cursor here. 



Type <L> (LAST line on screen) to move 



the cursor here. 



This part of the file is 
below the display window. 



Figures 6-3 through 6-6 summarize the vi commands for moving the cursor by.posi- 
tioning it on a character, line, word, sentence, paragraph, or position on the screen. 
(Additional vi commands for moving the cursor are summarized in Figure 6-7, later in 
the chapter.) 
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Positioning on a Character 


<h> 


Move the cursor one character to the left. 


<1> 


Move the cursor one character to the right. 


<BACKSPACE> 


Move the cursor one character to the left. 


< space bar> 


Move the cursor one character to the right. 


<fx> 


Move the cursor to the right to the specified 
character x. 


<Fx> 


Move the cursor to the left to the specified 
character x. 


<tx> 


Move the cursor to the right, to the character 
just before the specified character x. 


<TxB> 


Move the cursor to the left, to the character 
just after the specified character x. 


<;> 


Continue searching in same direction on the 
line for the last character requested with <f>, 

j ui ^1.^. i iiv 9 iciiicniucio me 

character and finds the next occurrence of it 
on the current line. 


<>> 


Continue searching in opposite direction on 
the line for the last character requested with 
<f>, <F>, <t>, or <T>. The , remembers 
the character and finds the next occurrence of 
it on the current line. 



Figure 6-3: Summary of vi Motion Commands (Sheet 1 of 4) 
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Positioning on a Line 


<k> 


Move the cursor up to the same column in the pre- 
vious line (if a character exists in that column). 


<j> 


Move the cursor down to the same column in the 
next line (if a character exists in that column). 


<-> 


Move the cursor up to the beginning of the previ- 
ous line. 


<+> 


Move the cursor down to the beginning of the next 
line. 


<CR> 


Move the cursor down to the beginning of the next 
line. 



Figure 6-4: Summary of vi Motion Commands (Sheet 2 of 4) 



Positioning on a Word 


<w> 


Move the cursor forward to the first character in 
the next word. 


<W> 


Ignore all punctuation and move the cursor for- 
ward to the next word delimited only by blanks. 


<b> 


Move the cursor backward one word to the first 
character of that word. 


<B> 


Move the cursor to the left one word, which is del- 
imited only by blanks. 


<e> 


Move the cursor to the end of the current word. 


<E> 


Delimit the words by blanks only. The cursor is 
placed on the last character before the next blank 
space, or end of the line. 



Figure 6-5: Summary of vi Motion Commands (Sheet 3 of 4) 
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Positioning on a Sentence 


<(> 


Move the cursor to the beginning of the current 
sentence. 


<)> 


Move the cursor to the beginning of the next sen- 
tence. 


Positioning on a Paragraph 


<{> 


Move the cursor to the beginning of the current 
paragraph. 


<}> 


Move the cursor to the beginning of the next para- 
graph. 


Positioning in the Window 


<H> 


Move the cursor to the first line on the screen (the 
home position). 


<M> 


Move the cursor to the middle line on the screen. 


<L> 


Move the cursor to the last line on the screen. 



Figure 6-6: Summary of vi Motion Commands (Sheet 4 of 4) 
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How do you move the cursor to text that is not shown in the current editing window? 
One option is to use the <20j> or <20k> command. However, if you are editing a 
large file, you need to move quickly and accurately to another place in the file. This 
section covers those commands that can help you move around within the file in the 
following ways: 

■ by scrolling forward or backward in the file 

■ by going to a specified line in the file 

■ by searching for a pattern in the file 



Four commands allow you to scroll the text of a file. The <t> (control-f) and <"d> 
(control-d) commands scroll the screen forward. The <"b> (control-b) and <"u> 
(control-u) commands scroll the screen backward. 

The Control-f Command 

The <"f> (control-f) command scrolls the text forward one full window of text below 
the current window. To do this vi clears the screen and redraws the window. The 
three lines that were at the bottom of the current window are placed at the top of the 
new window. If there are not enough lines left in the file to fill the window, the 
screen displays a ~ (tilde) to show that there are empty lines. 

vi clears and redraws the screen as follows: 



Scrolling the Text 



These last three lines of the current 
window become the first two lines of 
the new window. 



v. 



This part of the file 
is below the display 
window. 




You can scroll forward 
to place this text in the 
display window. 
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The Control-d Command 

The <~d> (control-d) command scrolls down a half screen to reveal text below the 
window. When you type <*d>, the text appears to be rolled up at the top and 
unrolled at the bottom. This allows the lines below the screen to appear on the 
screen, while the lines at the top of the screen disappear. If there are not enough 
lines in the file, a bell will sound. 

The Control-b Command 

The <T>> (control-b) command scrolls the screen back a full window to reveal the 
text above the current window. To do this, vi clears the screen and redraws the win- 
dow with the text that is above the current screen. Unlike the < A f> command, <"b> 
does not leave any reference lines from the previous window. If there are not enough 
lines above the current window to fill a full new window, a bell will sound and the 
current window will remain on the screen. 



Any text in this display window y 
will be placed below the current 
window. 

The current window clears and is re- 
drawn with the text above the window. 




This part of the file 
is above the display 
window. 



You can scroll backward 
to place this text in the 
display window. 




Now try scrolling backward. Type 



vi clears the screen and draws a new screen. 
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This part of the file 

is above the display window. 

You can scroll backward 
to place this text in the 
display window. 



Any text in this display window 
will be placed below the current 
window. 

The current window clears and is 
redrawn with the text above the 
window. 



Any text that was in the display window is placed below the current window. 

The Controhu Command 

The <"u> (control-u) command scrolls up a half screen of text to reveal the lines just 
above the window. The lines at the bottom of the window are erased. Now scroll 
down in the text, moving the portion below the screen into the window. Type: 

When the cursor reaches the top of the file, a bell sounds to notify you that the file 
cannot scroll further. 

Go to a Specified Line 

The <G> command positions the cursor on a specified line in the window; if that line 
is not currently on the screen, <G> clears the screen and redraws the window around 
it. If you do not specify a line, <G> goes to the last line of the file. 

<G> go to the last line of the file 

<nG> go to the nth line of the file 



Line Numbers 

Each line of the file has a line number corresponding to its position in the buffer. To 
get the number of a particular line, position the cursor on it and type <"g>. The 
<~g> command gives you a status notice at the bottom of the screen which tells you: 

■ the name of the file 

■ if the file has been modified 

■ the line number on which the cursor rests 

■ the total number of lines in the buffer 
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■ the percentage of the total lines in the buffer represented by the current line 

This line is the 35th line of the buffer. 
The cursor is on this line. 



<~g> 

There are several more lines in the 
buffer . 

The last line of the buffer is line 116. 

This line is the 35th line of the buffer . 
The cursor is on this line . 



There are several more lines in the 
buffer . 

The last line of the buffer is line 116. 
"file, name" [modified] line 36 of 116 — 34% — 



Searching for a Pattern of Characters: the / and ? 
Commands 

The fastest way to reach a specific place in your text is by using one of the search 
commands: /, ?, <n>, or <N>. These commands allow you to search forward or 
backward in the buffer for the next occurrence of a specified character pattern. The / 
and ? commands are not silent; they appear as you type them, along with the search 
pattern, on the bottom of the screen. The <n> and <N> commands, which allow 
you to repeat the requests you made for a search with a / or ? command, are silent. 

The /, followed by a pattern (/pattern), searches forward in the buffer for the next 
occurrence of the characters in pattern, and puts the cursor on the first of those char- 
acters. For example, the command line 

/Hello world<CR> 

finds the next occurrence in the buffer of the words Hello world and puts the cursor 
under the H. 

The ?, followed by a pattern (^pattern), searches backward in the buffer for the first 
occurrence of the characters in pattern, and puts the cursor on the first of those char- 
acters. For example, the command line 

?data set design<CR> 

finds the last occurrence in the buffer (before your current position) of the words data 
set design and puts the cursor under the d in data. 
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These search commands do not wrap around the end of a line while searching for two 
words. For example, say you are searching for the words Hello world. If Hello 
is at the end of one line and world is at the beginning of the next, the search com- 
mand will not find that occurrence of Hello World. 

However, they do wrap around the end or the beginning of the buffer to continue a 
search. For example, if you are near the end of the buffer, and the pattern for which 
you are searching (with the /pattern command) is at the top of the buffer, the com- 
mand will find the pattern. 

The <n> and <N> commands allow you to continue searches you have requested 
with /pattern or ^pattern without retyping them. 

<n> Repeat the last search command. 

<N> Repeat the last search command in the opposite direction. 

For example, say you want to search backward in the file for the three-letter pattern 
the. Initiate the search with Ithe and continue it with <n>. The following examples 
offer a step-by-step illustration of how the <n> searches backward through the file 
and finds four occurrences of the character string the. 

Suddenly, we spotted whales in the 
distance. Daniel was the first to see them. 

"Hey look! Here come the whales ! " he cried excitedly. 



?the 

Suddenly, we spotted whales in the 
distance. Daniel was the first to see them. 

"Hey look! Here cone the whales ! " he cried excitedly. 



(i) 



Suddenly, we spotted whales in the 
distance. Daniel was the first to see them. 

"Hey look! Here come the whales!" he cried excitedly. 



<n> 
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Suddenly, we spotted whales in the 
distance, Daniel was the first to see them. 



(2) 

"Hey look! Here come the whales!" he cried excitedly. 



Suddenly, we spotted whales in the 
distance. Daniel was the first to see them. 



<n> 

"Hey look! Here come the whales!" he cried excitedly. 

Suddenly, we spotted whales in the 
distance. Daniel was the first to see them. 

(3) 

"Hey look! Here come the whales!" he cried excitedly. 

Suddenly, we spotted whales in the 
distance. Daniel was the first to see them. 



<n> 

.P 

"Hey look! Here come the whales!" he cried excitedly. 
Suddenly, we spotted whales in the 



(4) 

distance. Daniel was the first to see them. 
,P 

"Hey look! Here come the whales!" he cried excitedly. 

The / and ? search commands do not allow you to specify particular occurrences of a 
pattern with numbers. You cannot, for example, request the third occurrence (after 
your current position) of a pattern. 
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Figure 6-7 summarizes the vi commands for moving the cursor by scrolling the text, 
specifying a line number, and searching for a pattern. 



Scrolling 


<Tf> 


Scroll the screen forward a full window, revealing the 
window of text below the current window. 


«Td> 


Scroll the screen down a half window, revealing lines 
below the current window. 


<"b> 


Scroll the screen back a full window, revealing the 
window of text above the current window. 


<u> 


Scroll the screen up a half window, revealing the lines 
of text above the current window. 


Positioning on a Numbered Line 


<1G> 


Go to the first line of the file. 


<G> 


Go to the last line of the file. 


<g> 


Give the line number and file status. 


Searching for a Pattern 


/pattern 


Search forward in the buffer for the next occurrence 
of the pattern. Position the cursor on the first charac- 
ter of the pattern. 


^pattern 


Search backward in the buffer for the first occurrence 
of the pattern. Position the cursor under the first char- 
acter of the pattern. 


<n> 


Repeat the last search command. 


<N> 


Repeat the search command in the opposite direction. 



Figure 6-7: Summary of Additional vi Motion Commands 
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2-1. Create a file called exer2. Type a number on each line, numbering the lines 
from 1 to 50. Your file should look similar to the following. 



1 
2 
3 



48 
49 
50 



2-2. Try using each of the scroll commands, noticing how many lines scroll 
through the window. Try the following: 

<Tf> 
<Tb> 
<Tu> 

2-3. Go to the end of the file. Append the following line of text. 



123456789 123456789 



What number does the command <7h> place the cursor on? What number 
does the command <31> place the cursor on? 

2-4. Try the command <$> and the command <0> (number zero). 

2-5. Go to the first character on the line that is not a blank. Move to the first 

character in the next word. Move back to the first character of the word to 
the left. Move to the end of the word. 

2-6. Go to the first line of the file. Try the commands that place the cursor in the 
middle of the window, on the last line of the window, and on the first line of 
the window. 

2-7, Search for the number 8. Find the next occurrence of the number 8. Find 
48. 
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There are three basic commands for creating text: 
<a> append text 
<i> insert text 

<o> open a new line on which text can be entered 

After you finish creating text with any one of these commands, you can return to the 
command mode of vi by pressing the ESCAPE key. 

Appending Text 

<a> append text after the cursor 

<A> append text at the end of the current line 

You have already experimented with the <a> command in the "Creating a File" sec- 
tion. Make a new file named junk2. Append some text using the <a> command. 
To return to command mode of vi, press the ESCAPE key. Then compare the <a> 
command to the <A> command. 

Inserting Text 

<i> insert text before the cursor 

<I> insert text at the beginning of the current line before the first character 
that is not a blank 

To return to the command mode of vi, press the ESCAPE key. 

In the following examples you can compare the append and insert commands. The 
arrows show the position of the cursor, where new text will be added. 

Append three spaces AFTER the H of Here 

<a> 

Append three spaces AFTER the H of H ere. 

<ESC> 



6-34 USER'S GUIDE 



Creating Text 



Insert three spaces BEFORE the H of Here. 



<i>. 

Insert three spaces BEFORE the H of Here. 



<ESC> 



Notice that in both cases, the user has left text input mode by pressing the ESCAPE 
key. 



Opening a Line for Text 

<o> Create text from the beginning of a new line below the current line. You 
can issue this command from any point in the current line. 

<0> Create text from the beginning of a new line above the current line. This 
command can also be issued from any position in the current line. 

The open command creates a directly above or below the current line, and puts you 
into text input mode. For example, in the following examples the <0> command 
opens a line above the current line, and the <o> command opens a line below the 
current line. In both cases, the cursor waits for you to enter text from the beginning 
of the new line. 

Create text ABOVE the current line. 



<o> 

[blank line] 

Create text ABOVE the current line. 



Now create text BELOW the current line. 



<o> 

Now create text BELOW the current line, 
[blank line] 
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Figure 6-8 summarizes the commands for creating and adding text with the vi editor. 





r unciion 




^reaie text aiier ine cursor. 


<A> 


Create text at the end of the current line. 


<i> 


Create text in front of the cursor. 


<I> 


Create text before the first character on 
the current line that is not a blank, 


<0> 


Create text at the beginning of a new line 
below the current line. 


<o> 


Create text at the beginning of a new line 
above the current line. 


<ESC> 


Return vi to command mode from any of 
the above text input modes. 



Figure 6-8: Summary of vi Commands for Creating Text 
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3-1. Create a text file called, exert. 

3-2. Insert the following four lines of text. 

Append text 
Insert text 
a computer's 
job is boring. 

3-3. Add the following line of text above the last line: 
financial statement and 

3-4. Using a text insert command, add the following line of text above the third 
line: 

Delete text 

3-5. Add the following line of text below the current line: 
byte of the budget 

3-6. Using an append command, add the following line of text below the last line: 

But 9 it is an exciting machine. 

3-7. Move to the first line and add the word some before the word text. 

Now practice using each of the six commands for creating text. 

3-8. Leave vi and go on to the next section to find out how to delete any mistakes 
you made in creating text. 
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You can delete text with various commands in command mode, and undo the entry of 
small amounts of text in text input mode. In addition, you can undo entirely the 
effects of your most recent command. 



Undoing Entered Text in Text Input Mode 

To delete a character at a time when you are in text input mode use the BACK- 
SPACE key. 

<BACKSPACE> Delete the current character (the character shown by the cur- 
sor). 

The BACKSPACE key backs up the cursor in text input mode and deletes each char- 
acter that the cursor backs across. However, the deleted characters are not erased 
from the screen until you type over them or press the ESCAPE key to return to com- 
mand mode. 

In the following example, the arrows represent the cursor. 
Mary had a litttl 



<BACKSPACE> <BACKSPACE> 

Mary had a litttl 



<ESC> 



Mary had a litt 



Notice that the characters are not erased from the screen until you press the 
ESCAPE key. 

There are two other keys that delete text in text input mode. Although you may not 
use them often, you should be aware that they are available. To remove the special 
meanings of these keys so that they can be typed as text, see the section on special 
commands. 

<"w> undo the entry of the current word 

<@> delete all text entered on current line since text input mode was entered 

When you type <Tw>, the cursor backs up over the word last typed and waits on the 
first character. It does not literally erase the word until you press the ESCAPE key 
or enter new characters over the old ones. The sign behaves in a similar 

manner except that it removes all text you have typed on the current line since you 
last entered input mode. 



6-38 USER'S GUIDE 



Deleting Text 



Undo the Last Command 

Before you experiment with the delete commands, you should try the u command. 
This command undoes the last command you issued. 

<u> undo the last command 

<U> restore the current line to its state before you changed it 

If you delete lines by mistake, type <u>; your lines will reappear on the screen. If 
you type the wrong command, type <u> and it will be nullified. The <U> command 
will nullify all changes made to the current line as long as the cursor has not been 
moved from it. 

If you type <u> twice in a row, the second command will undo the first; your undo 
will be undone! For example, say you delete a line by mistake and restore it by typing 
<u>. Typing <u> a second time will delete the line again. Knowing this command 
can save you a lot of trouble. 



Delete Commands in Command Mode 

You know that you can precede a command by a number. Many of the commands in 
vi, such as the delete and change commands, also allow you to enter a cursor move- 
ment command after another command. The cursor movement command can specify 
a text object such as a word, line, sentence, or paragraph. The general format of a vi 
command is: 

[number][command]text_object 

The brackets around some components of the command format show that those com- 
ponents are optional. 

All delete commands issued in command mode immediately remove unwanted text 
from the screen and redraw the affected part of the screen. 

The delete command follows the general format of a vi command. 

[number]dtext„object 

Deleting Words 

You can delete a word or part of a word with the <dw> command. Move the cursor 
to the first character to be deleted and type <dw>. The character under the cursor 
and all subsequent characters in that word will be erased. 

the deep dark depths of the lake. 



<2dw> 
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the depths of the lake. 



The <dw> command deletes one word or punctuation mark and the space(s) that fol- 
low it. You can delete several words or marks at once by specifying a number before 
the command. For example, to delete three words and two commas, type <5dw>. 

the deep/ deep, dark depths of the lake 

<5dw> 

the depths of the lake 



Deleting Paragraphs 

To delete paragraphs, use the following commands. 
<d{> or <d}> 

Observe what happens to your file. Remember, you can restore the deleted text with 
<u>. 

Deleting Lines 

To delete a line, type <dd>. To delete multiple lines, specify a number before the 
command. For example, typing 

<lOdd> 

will erase ten lines. If you delete more than a few lines, vi will display this notice on 
the bottom of the screen: 

10 lines deleted 

If there are less than ten lines below the current line in the file, a bell will sound and 
no lines will be deleted. 

Deleting Text After the Cursor 

To delete all text on a line after the cursor, put the cursor on the first character to be 
deleted and type 

<K»or<d$>. 

Neither of these commands allows you to specify a number of lines; they can be used 
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only on the current line. 

Figure 6-9 summarizes the vi commands for deleting text. 



Command 


W71. A. 2 _ 

Function 


For INSERT Mode: 




<BACKSPACE> 


Delete the current character. 




Delete the current character. 


«rw> 


Delete the current word. 


<@> 


Delete the current line of new text or 
delete all new text on the current line. 


For COMMAND Mode: 




<u> 


Undo the last command. 


<u> 


Restore current line to its previous state. 


<x> 


Delete the current character. 


<ndx> 


Delete n number of text objects of type x. 


<dw> 


Delete the word at the cursor through the 

nPY"f <JTiJif*p or tr> tlif* tiPYt minr* tuition 

mark. 


<dW> 


Delete the word and punctuation at the 
cursor through the next space. 


<dd> 


Delete the current line. 


<D> 


Delete the portion of the line to the right 
of the cursor. 


<d)> 


Delete the current sentence. 


<d}> 


Delete the current paragraph. 



Figure 6-9: Summary of Delete Commands 
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4-1. Create a file called exer4 and put the following four lines of text in it: 

When in the course of human events 
there are many repetitive, boring 
chores, then one ought to get a 
robot to perform those chores* 

4-2. Move the cursor to line two and append to the end of that line: 

tedious and unsavory. 

Delete the word unsavory while you are in append mode. 

Delete the word boring while you are in command mode. 

What is another way you could have deleted the word boring? 
4-3. Insert at the beginning of line four: 

congenial and computerized* 

Delete the line, 

How can you delete the contents of the line without removing the line itself? 

Delete all the lines with one command, 
4-4. Leave the screen editor and remove the empty file from your directory. 
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The delete commands and text input commands provide one way for you to modify 
text. Another way you can change text is by using a command that lets you delete 
and create text simultaneously. There are three basic change commands: <r>, <s>, 
and <c>. 



Replacing Text 

<r> Replace the current character (the character shown by the cursor). This 
command does not initiate text input mode, and so does not need to be 
followed by pressing the ESCAPE key. 

<nr> Replace n characters with the same letter. This command automatically 
terminates after the nth character is replaced. It does not need to be fol- 
lowed by pressing the ESCAPE key. 

<R> Replace only those characters typed over until the ESCAPE command is 
given. If the end of the line is reached, this command will append the 
input as new text. 

The <r> command replaces the current character with the next character that is 
typed in. For example, suppose you want to change the word acts to ants in the fol- 
lowing sentence: 

The circus has many acts . 
Place the cursor under the c of acts and type 

<r>n 
The sentence becomes 

The circus has many ants . 
To change many to 7777, place the cursor under the m of many and type 

<4r7> 

The <r> command changes the four letters of many to four occurrences of the 
number seven. 

The circus has 7777 ants. 



Substituting Text 

The substitute command replaces characters, but then allows you to continue to insert 
text from that point until you press the ESCAPE key. 

<s> Delete the character shown by the cursor and append text. End the text 
input mode by pressing the ESCAPE key. 

<m> Delete n characters and append text. End the text input mode by pressing 
the ESCAPE key. 

<S> Replace all the characters in the line. 
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When you enter the <s> command, the last character in the string of characters to 
be replaced is overwritten by a $ sign. The characters are not erased from the screen 
until you type over them, or leave text input mode by pressing the ESCAPE key. 

Notice that you cannot use an argument with either <r> or <s>. Did you try? 

Suppose you want to substitute the word million for the word hundred in the sentence 
My salary is one hundred dollars . Put the cursor under the h of hundred 
and type <7s>. Notice where the $ sign appears. 

My salary is one hundred dollars . 



<7s> 

Then type million. 

My salary is one hundre$ dollars. 



million 



My salary is one million dollars . 



Changing Text 

The substitute command replaces characters. The change command replaces text 
objects, and then continues to append text from that point until you press the 
ESCAPE key. To end the change command, press the ESCAPE key. 

The change command can take an argument. You can replace a character, word, or 
an entire line with new text, 

<ncx> Replace n number of text objects of type x, such as sentences (shown 
by <)>) and paragraphs (shown by <}>). 

<cw> Replace a word or the remaining characters in a word with new text. 

The vi editor prints a $ sign to show the last character to be changed. 

</zcw> Replace n words. 

<cc> Replace all the characters in the line. 

<ncc> Replace all characters in the current line and up to n lines of text. 

<C> Replace the remaining characters in the line, from the cursor to the 
end of the line. 
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<nC> Replace the remaining characters from the cursor in the current line 
and replace all the lines following the current line up to n lines. 

The change commands, <cw> and <C>, use a $ sign to mark the last letter to be 
replaced. Notice how this works in the following example: 

They are now due to arrive on Tuesday. 



<cw> 



They are now due to arrive pn Tuesda$. 



Wednesday<ESC> 



They are now due to arrive on Wednesday. 



Notice that the new word (Wednesday) has more letters than the word it 
replaced (Tuesday). Once you have executed the change command you are in text 
input mode and can enter as much text as you want. The buffer will accept text until 
you press the ESCAPE key. 

The <C> command, when used to change the remaining text on a line, works in the 
same way. When you enter the command it uses a $ sign to mark the end of the text 
that will be deleted, puts you in text input mode, and waits for you to type new text 
over the old. The following examples offer an example of the C command. 

This is line 1. 

Oh, I must have the wrong number. 



<C> 

This is line 3 . 
This is line 4 . 

This is line 1. 

Oh, I must have the wrong number? 



This is line 2.<ESC> 

This is line 3 . 
This is line 4 . 
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This 


is 


line 


1 


This 


is 


line 


2 


This 


is 


line 


3 


This 


is 


line 


4 



Now try combining arguments. For example, type 
<c{> 

Because you know the undo command, do not hesitate to experiment with different 
arguments or to precede the command with a number. You must press the ESCAPE 
key before using the <u> command, since <c> places you in text input mode. 

Compare <S> and <cc>. The two commands should produce the same results. 

Figure 6-10 summarizes the vi commands for changing text. 



Command 


Function 


<r> 


Replace the current character. 


<R> 


Replace only those characters typed over with 
new characters until the ESCAPE key is 
pressed. 


<s> 


Delete the character the cursor is on and 
append text. End the append mode by press- 
ing the ESCAPE key. 


<S> 


Replace all the characters in the line. 


<cc> 


Replace all the characters in the line. 


<ncx> 


Replace n number of text objects of type x, 
such as sentences (shown by <)>) and para- 
graphs (shown by <}>). 


| <cw> 


Replace a word or the remaining characters in 
a word with new text. 


<C> 


Replace the remaining characters in the line, 
from the cursor to the end of the line. 



Figure 6-10: Summary of vi Commands for Changing Text 
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vi provides a set of commands that cut and paste text in a file. Another set of com- 
mands copies a portion of text and places it in another section of a file. 

Moving Text 

You can move text from one place to another in the vi buffer by deleting the lines and 
then placing them at the required point. The last text that was deleted is stored in a 
temporary buffer. If you move the cursor to that part of the file where you want the 
deleted lines to be placed and press the p key, the deleted lines will be added below 
the current line. 

<p> Place the contents of the temporary buffer after the cursor. 

A partial sentence that was deleted by the <D> command can be placed in the mid- 
dle of another line. Position the cursor in the space between two words, then press 
<p>. The partial line is placed after the cursor. 

Characters deleted by <nx> also go into a temporary buffer. Any text object that 
was just deleted can be placed somewhere else in the text with <p>. 

The <p> command should be used right after a delete command since the temporary 
buffer only stores the results of one command at a time. The <p> command is also 
used to copy text placed in the temporary buffer by the yank command. The yank 
command (<y>) is discussed in "Copying Text." 



Fixing Transposed Letters 

A quick way to fix transposed letters is to combine the <x> and the <p> commands 
as <xp>. <x> deletes the letter. <p> places it after next character. 

Notice the error in the next line. 

A line of tetx 

This error can be changed quickly by placing the cursor under the t in tx and then 
pressing the <x> and <p> keys, in that order. The result is: 

A line of text 

Try this. Make a typing error in your file and use the <xp> command to correct it. 
Why does this command work? 



Copying Text 

You can yank (copy) one or more lines of text into a temporary buffer, and then put a 
copy of that text anywhere in the file. To put the text in a new position type <p>; 
the text will appear on the next line. 
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The yank command follows the general format of a vi command. 
[number]y[text^object] 

Yanking lines of text does not delete them from their original position in the file. If 
you want the same text to appear in more than one place, this provides a convenient 
way to avoid typing the same text several times. However, if you do not want the 
same text in multiple places, be sure to delete the original text after you have put the 
text into its new position. 

Figure 6-11 summarizes the ways you can use the yank command. 



Command 


Function 


<nyx> 


Yank n number of text objects of type x, (such 
as sentences ) and paragraphs }). 


<yw> 


Yank a copy of a word. 


<yy> 


Yank a copy of the current line. 


<nyy> 


Yank n lines. 


<y)> 


Yank all text up to the end of a sentence. 


<y}> 


Yank all text up to the end of the paragraph. 



Figure 6-11 : Summary of the Yank Command 



Notice that this command allows you to specify the number of text objects to be 
yanked. 

Try the following command lines and see what happens on your screen. (Remember, 
you can always undo your last command.) Type: 

<5yw> 

Move the cursor to another spot. Type; 
<P> 

Now try yanking a paragraph <y}> and placing it after the current paragraph. Then 
move to the end of the file <G> and place that same paragraph at the end of the file. 



Copying or Moving Text Using Registers 

Moving or copying several sections of text to a different part of the file is tedious 
work, vi provides a shortcut for this: named registers in which you can store text 
until you want to move it. To store text you can either yank or delete the text you 
wish to store. 
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Using registers is useful if a piece of text must appear in many places in the file. The 
extracted text stays in the specified register until you either end the editing session, or 
yank or delete another section of text to that register. 

The general format of the command is: 

[number]["x]command[text„object] 

The x is the name of the register and can be any single letter. It must be preceded by 
a double quotation mark. For example, place the cursor at the beginning of a line. 
Type: 

<3"ayy> 

Type in more text and then go to the end of the file. Type: 
<"ap> 

Did the lines you saved in register a appear at the end of the file? 
Figure 6-12 summarizes the cut and paste commands. 



Command 


Function 


<p> 


Place the contents of the temporary buffer 
containing the text obtained from the most 
recent delete or yank command into the text 
after the cursor. 


<yy> 


Yank a line of text and place it into a tem- 
porary buffer. 


<nyx> 


Yank a copy of n number of text objects of 
type x and place them in a temporary buffer. 


<"xyn> 


Place a copy of a text object of type n in the 
register named by the letter x. 


<"xp> 


Place the contents of the register x after the 
cursor. 



Figure 6-12: Summary of vi Commands for Cutting and Pasting Text 
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54. Enter vi with the file called exer2. that you created in Exercise 2. 

Go to line eight and change its contents to END OF FILE 

5-2. Yank the first eight lines of the file and place them in register z. Put the con- 
tents of register z after the last line of the file. 

5-3. Go to line eight and change its contents to eight is great 

5-4. Go to the last line of the file. Substitute EXERCISE for file. Replace OF 
with TO. 
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Here are some special commands that you will find useful. 
<•> repeat the last command 
<J> join two lines together 
<1> clear the screen and redraw it 
<""> change lower case to upper case and vice versa 



Repeating the Last Command 

The . period repeats the last command to create, delete, or change text in the file. It 
is often used with the search command. 

For example, suppose you forget to capitalize the S in United States. However, you 
do not want to capitalize the s in chemical states. One way to correct this problem is 
by searching for the word states. The first time you find it in the expression United 
States, you can change the s to S. Then continue your search. When you find 
another occurrence, you can simply type a period; vi will remember your last com- 
mand and repeat the substitution of s for S. 

Experiment with this command. For example, if you try to add a period at the end of 
a sentence while in command mode, the last text change will suddenly appear on the 
screen. Watch the screen to see how the text is affected. 



Joining Two Lines 

The <J> command joins lines. To enter this command, place the cursor on the 
current line, and press the SHIFT and j keys simultaneously. The current line is 
joined with the following line. 

For example, suppose you have the following two lines of text: 

Dear Mr. 
Smith : 

To join these two lines into one, place the cursor under any character in the first line 
and type: 

<J> 

You will immediately see the following on your screen: 
Dear Mr. Smith: 

Notice that vi automatically places a space between the last word on the first line and 
the first word on the second line. 
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Clearing and Redrawing the Window 

If another UMIPS system user sends you a message using the write command while 
you are editing with vi, the message will appear in your current window, over part of 
the text you are editing. To restore your text after you have read the message, you 
must be in command mode. (If you are in text input mode, press the ESCAPE key 
to return to command mode,) Then type < A 1> (control-!), vi will erase the message 
and redraw the window exactly as it appeared before the message arrived. 



Changing Lower Case to Upper Case and Vice Versa 

A quick way to change any lower case letter to upper case, or vice versa, is by putting 
the cursor on the letter to be changed and typing a <~> (tilde). For example, to 
change the letter a to A, press ~. You can change several letters by typing ~ several 
times, but you cannot precede the command with a number to change several letters 
with one command, 

Figure 6-13 summarizes the special commands. 



Command 


Function 


<•> 


Repeat the last command. 


<J> 


Join the line below the current line with the current 
line. 


<ri> 


Clear and redraw the current window. 


<~> 


Change lower case to upper case, or vice versa. 



Figure 6-13: Summary of Special Commands 
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The vi editor has access to many of the commands provided by a line editor called ex. 
(For a complete list of ex commands see the ex(l) page in the User's Reference 
Manual.) This section discusses some of those most commonly used. 

The ex commands are very similar to the ed commands discussed in Chapter 5. If 
you are familiar with ed, you may want to experiment on a test file to see how many 
ed commands also work in vi. 

Line editor commands begin with a : (colon). After the colon is typed, the cursor 
will drop to the bottom of the screen and display the colon. The remainder of the 
command will also appear at the bottom of the screen as you type it. 

Temporarily Returning to the Shell: the :sh and :! 
Commands 

When you enter vi, the contents of the buffer fill your screen, making it impossible to 
issue any shell commands. However, you may want to do so. For example, you may 
want to get information from another file to incorporate into your current text. You 
could get that information by running one of the shell commands that display the text 
of a file on your screen, such as the cat or pg command. However, quitting and 
reentering the editor is time consuming and tedious, vi offers two methods of escap- 
ing the editor temporarily so that you can issue shell commands (and even edit other 
files) without having to write your buffer and quit: the :! command and the :sh com- 
mand. 

The :! command allows you to escape the editor and run a shell command on a single 
command line. From the command mode of vi, type :!. These characters will be 
printed at the bottom of your screen. Type a shell command immediately after the !. 
The shell will run your command, give you output, and print the message [Hit 
return to continue] . When you press the RETURN key vi will refresh the 
screen and the cursor will reappear exactly where you left it. 

The ex command :sh allows you to do the same thing, but behaves differently on the 
screen. From the command mode of vi type :sh and press the RETURN key. A shell 
command prompt will appear on the next line. Type your command(s) after the 
prompt as you would normally do while working in the shell. When you are ready to 
return to vi, type <"d> or exit; your screen will be refreshed with your buffer con- 
tents and the cursor will appear where you left it. 

Even changing directories while you are temporarily in the shell will not prevent you 
from returning to the vi buffer where you were editing your file when you type exit or 

<ra>. 



Writing Text to a New File: the :w Command 

The :w (for write) command allows you to create a file by copying lines of text from 
the file your are currently editing into a file that you specify. To create your new file 
you must specify a line or range of lines (with their line numbers), along with the 
name of the new file, on the command line. You can write as many lines as you like 
The general format is: 

ilinejnumber[, line^numberjw filename 
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For example, to write the third line of the buffer to a line named three, type: 
:3w three<CR> 

vi reports the successful creation of your new file with the following information: 
"three" [New file] 1 line, 20 characters 

To write your current line to a file, you can use a . (period) as the line address: 
;.w junk<CR> 

A new file called junk will be created. It will contain only the current line in the vi 
buffer. 

You can also write a whole section of the buffer to a new file by specifying a range of 
lines. For example, to write lines 23 through 37 to a file, type the following: 

:23,37w newflle<CR> 

Finding the Line Number 

To determine the line number of a line, move the cursor to it and type : (colon). 
The colon will appear at the bottom of the screen. Type •= after it and press the 
RETURN key. 

If you want to know the number 
of this line, type :.=<CR> 



As soon as you press the RETURN key, your command line will disappear from the 
bottom line and be replaced by the number of your current line in the buffer. 

If you want to know the number 
of this line, type in :.=<CR> 

34 

You can move the cursor to any line in the buffer by typing : and the line number. 
The command line 

m<CR> 

means to go to the nth line of the buffer. 

Deleting the Rest of the Buffer 

One of the easiest ways to delete all the lines between the current line and the end of 
the buffer is by using the line editor command d with the special symbols for the 
current and last lines. 

:.,$d<CR> 
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The . represents the current line; the $ sign, the last line. 



Adding a File to the Buffer 

To add text from a file below a specific line in the editing buffer, use the :r (read) 
command. For example, to put the contents of a file called data into your current 
file, place the cursor on the line above the place where you want it to appear. Type: 

:r data<CR> 

You may also specify the line number instead of moving the cursor. For example, to 
insert the file data below line 56 of the buffer, type 

:56r data<CR> 

Do not be afraid to experiment; you can use the <u> command to undo ex com- 
mands, too. 



Making Global Changes 

One of the most powerful commands in ex is the global command. The global com- 
mand is given here to help those users who are familiar with the line editor. Even if 
you are not familiar with a line editor, you may want to try the command on a test 
file. 

For example, say you have several pages of text about the DNA molecule in which 
you refer to its structure as a helix. Now you want to change every occurrence of the 
word helix to double helix. The ex editor's global command allows you to do this 
with one command line. First, you need to understand a series of commands. 

ig/pattem/command<CR> 

For each line containing pattern, execute the ex command named com- 
mand. For example, type: :g/helix<CR>. The line editor will print all 
lines that contain the pattern helix. 

:s/pattern/new_words/<CR> 

This is the substitute command. The line editor searches for the first 
instance of the characters pattern on the current line and changes them to 
newjwords. 

:s/pattern/new_words/g<CR> 

If you add the letter g after the last delimiter of this command line, ex will 
change every occurrence of pattern on the current line. If you do not, ex 
will change only the first occurrence. 

:g/helix/s/J 'double helix/g<CR> 

This command line searches for the word helix. Each time helix is found, 
the substitute command substitutes two words, double helix, for every 
instance of helix on that line. The delimiters after the s do not need to 
have helix typed in again. The command remembers the word from the 
delimiters after the global command g. This is a powerful command. For 
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a more detailed explanation of global and substitution commands, see 
Chapter 5. 

Figure 6-14 summarizes the line editor commands available in vi. 



Command 


Function 




Shows that the commands that follow 
are line editor commands. 


jsh<CR> 


Temporarily returns you to the shell to 
perform shell commands. 


<Td> 


Escapes the temporary shell and 
returns you to the current window of vi 
to continue editing. 


:n<CR> 


Goes to the nth line of the buffer. 


:x,yw data<CR> 


Writes lines from the number x 
through the number y into a new file 
(data). 


:$<CR> 


Goes to the last line of the buffer. 


;.,$d<CR> 


Deletes all the lines in the buffer from 
the current line to the last line. 


:r shell.file<CR> 


Inserts the contents of shell.file after 
the current line of the buffer. 


ts/ text/new jword$/<CR> 


Replaces the first instance of the char- 
acters text on the current line with 
new_words. 


is/text/new„words/g<CR> 


Replaces every occurrence of text on 
the current line with newjwords. 


tg/text/s//new„words/g<CHL> 


Replaces every occurrence of text in 
the file with newjwords. 



Figure 6-14: Summary of Line Editor Commands 
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There are five basic command sequences to quit the vi editor. Commands that are 
preceded by a colon (:) are line editor commands. 

<ZZ> or :wq<CR> Write the contents of the vi buffer to the UMIPS 

file currently being edited and quit vi. 

Write the temporary buffer to a new file named 
filename and quit vi. 

Overwrite an existing file called filename with the 
contents of the buffer and quit vi. 

Quit vi without writing the buffer to a file, and dis- 
card all changes made to the buffer. 

Quit vi without writing the buffer to a UMIPS file. 
This works only if you have made no changes to 
the buffer; otherwise vi will warn you that you 
must either save the buffer or use the :q!<CR> 
command to terminate. 



The <ZZ> command and :wq command sequence both write the contents of the 
buffer to a file, quit vi, and return you to the shell. You have tried the <ZZ> com- 
mand. Now try to exit vi with :wq. vi remembers the name of the file currently being 
edited, so you do not have to specify it when you want to write the buffer's contents 
back into the file. Type 

:wq<CR> 

The system responds in the same way it does for the <ZZ> command. It tells you 
the name of the file, and reports the number of lines and characters in the file. 

What must you do to give the file a different name? For example, suppose you want 
to write to a new file called junk. Type: 

:w junk<CR> 

After you write to the new file, leave vi. Type: 
:q<CR> 

If you try to write to an existing file, you will receive a warning. For example, if you 
try to write to a file called johnson, the system will respond with: 

"johnson" File exists - use "w! johnson" to overwrite 

If you want to replace the contents of the existing file with the contents of the buffer, 
use the :w! command to overwrite johnson. 

:w! johnson<CR> 

Your new file will overwrite the existing one. 



:w filename<CR> 
:q<CR> 

:w! filename<CR> 
:q<CR> 

:q!<CR> 
:q<CR> 
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If you edit a file called memo, make some changes to it, and then decide you don't 
want to keep the changes, or if you accidentally press a key that gives vi a command 
you cannot undo, leave vi without writing to the file. Type: 

sq!<CR> 

Figure 6-15 summarizes the quit commands. 



Command 


Function 


<ZZ> 


Write the file and quit vi. 


swq<CR> 


Write the file and quit vi. 


:w filename<CR> 
sq<CR> 


Write the editing buffer to a new file (filename) 
and quit vi. 


sw! filename<CR> 
:q<CR> 


Overwrite an existing file (filename) with the con- 
tents of the editing buffer and quit vi. 


sq!<CR> 


Quit vi without writing buffer to a file. 


sq<CR> 


Quit vi without writing the buffer to a file. 



Figure 6-15: Summary of the Quit Commands 
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Special Options For vi 



The vi command has some special options. It allows you to: 

■ recover a file lost by an interrupt to the UMIPS system 

■ place several files in the editing buffer and edit each in sequence, and 

■ view the file at your own pace by using the vi cursor positioning commands 



Recovering a File Lost by an Interrupt 

If there is an interrupt or disconnect, the system will exit the vi command without 
writing the text in the buffer back to its file. However, the UMIPS system will store a 
copy of the buffer for you. When you log back in to the UMIPS system you will be 
able to restore the file with the -r option for the vi command. Type 

vi — r filename<CR> 

The changes you made to filename before the interrupt occurred are now in the vi 
buffer. You can continue editing the file, or you can write the file and quit vi. The vi 
editor will remember the file name and write to that file. 



Editing Multiple Files 

If you want to edit more than one file in the same editing session, issue the vi com- 
mand, specifying each file name. Type 

vi filel file2<CR> 

vi responds by telling you how many files you are going to edit. For example: 
2 files to edit 

After you have edited the first file, write your changes (in the buffer) to the file (filel). 
Type 

:w<CR> 

The system response to the :w <CR> command will be a message at the bottom of 
the screen giving the name of the file, and the number of lines and characters in that 
file. Then you can bring the next file into the editing buffer by using the :n command. 
Type 

:n<CR> 

The system responds by printing a notice at the bottom of the screen, telling you the 
name of the next file to be edited and the number of characters and lines in that file. 

Select two of the files in your current directory. Then enter vi and place the two files 
in the editing buffer at the same time. Notice the system responses to your com- 
mands at the bottom of the screen. 
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Viewing a File 

It is often convenient to be able to inspect a file by using vi's powerful search and 
scroll capabilities. However, you might want to protect yourself against accidentally 
changing a file during an editing session. The read-only option prevents you from 
writing in a file. To avoid accidental changes, you can set this option by invoking the 
editor as view rather than vi. 

Figure 6-16 summarizes the special options for vi. 



Option 


Function 


vi ftlel file! file3<CR> 

sw<CR> 
:n<CR> 

vi -r filel<CK> 


Enter three files (filel, filel, and fileS) 
into the vi buffer to be edited. 

Write the current file and call the next 
file into the buffer. 

Restore the changes made to filel. 



Figure 6-16: Summary of Special Options for vi 
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6-1. Try to restore a file lost by an interrupt. 

Enter vi, create some text in a file called exer6. Turn off your terminal 
without writing to a file or leaving vi. Turn your terminal back on, and log in 
again. Then try to get back into vi and edit exer6. 

6-2. Place exerl and exer2 in the vi buffer to be edited. Write exerl and call in 
the next file in the buffer, exer2. 

Write exer2 to a file called junk. 

Quit vi. 

6-3. Try out the command: 
vi exer*<CR> 

What happens? Try to quit all the files as quickly as possible. 
6-4. Look at exer4 in read-only mode. 

Scroll forward. 

Scroll down. 

Scroll backward. 

Scroll up. 

Quit and return to the shell. 
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There is often more than one way to perform a task in vi. Any method that works is 
correct. The following are suggested ways of doing the exercises. 

Exercise 1 

1-1. Ask your system administrator for your terminal's system name. Type: 

TERM-terminaLname<CR> 
1-2. Enter the vi command for a file called exerl: 

vi exerl<CR> 

Then use the append command (<a>) to enter the following text in your file: 

This is an exercise!<CR> 

Up, down<CR> 

left, right,<CR> 

build your terminal's<CR> 

muscles bit by bit<ESC> 

1-3. Use the <k> and <h> commands. 

1-4. Use the <x> command. 

1-5. Use the <j> and <I> commands. 

1-6. Enter vi and use the append command (<a>) to enter the following text: 

and byte by byte<ESC> 

Then use <j> and <1> to move to the last line and character of the file. Use 
the <a> command again to add text. You can create a new line by pressing 
the RETURN key. To leave text input mode, press the ESCAPE key. 

1-7. Type: 

<ZZ> 

1-8. Type: 

vi exerl<CR> 

Notice the system response: 

"exerl" 7 lines, 102 characters 
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Exercise 2 

2-1. Type: 



vi e\er2<CR> 
<a>KCR> 
2<CR> 
3<CR> 



48<CR> 
49<CR> 
50<ESC> 

2-2. Type: 

< A f> 
< A b> 
< A u> 
<"d> 

Notice the line numbers as the screen changes. 
2-3. Type: 

<G> 
<o> 

123456789 123456789<ESC> 

<7h> 

<3I> 

Typing <7h> puts the cursor 

on the 2 in the second set of numbers. 

Typing <31> puts the cursor 

on the 5 in the 

second set of numbers. 

2-4. $ = end of line 

0 = first character in the line 

2-5. Type: 

< A > 
<w> 
<b> 
<e> 

2-6. Type: 

<1G> 
<M> 
<L> 
<H> 

2-7. Type: 

/8 

<n> 
/48 
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Exercise 3 

34. Type: 

vi exer3<CR> 

3-2. Type: 

<a> Append text <CR> 
Insert text<CR> 
a computer's <CR> 
job is boring.<ESC> 

3-3. Type: 

<o> 

financial statement and<ESC> 

3-4. Type: 

<3G> 

<i>Delete text<CR><ESC> 

The text in your file now reads: 

Append text 

Insert text 

Delete text 

a computer' s 

financial statement and 

job is boring. 

3-5, The current line is a computer' s. To create a line of text below that line 
use the <o> command. 

3-6. The current line is byte of the budget. 
<G> puts you on the bottom line. 
<A> lets you begin appending at the end of the line, 
<CR> creates the new line. 
Add the sentence: But, it is an exciting machine. 
<ESC> leaves append mode. 

3-7. Type: 

<1G> 
/text 

<i>some<$pace barXESO 
3-8. <ZZ> will write the buffer to exer3 and return you to the shell. 



Exercise 4 

4-1. Type: 

viexer4<CR> 

<a> When in the course of human events<CR> 
there are many repetitive, boring<CR> 
chores, then one ought to get a<CR> 
robot to perform those chores.<ESC> 
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4-2. Type: 

<2G> 

<A> tedious and unsavoiy<8BACKSPACEXCR> 
<ESC> 

Press <h> until you get to the b of boring. Then type: 
<dw>. (You can also use <6x>.) 

4-3. You are at the second line. Type: 
<2j> 

<I> congenial and computerized<ESC > 
<dd> 

To delete the line and leave it blank, type in: 

<0> (zero moves the cursor to the beginning of the line) 
<D> 

<H> 
<3dd> 

4-4. Write and quit vi. 

<ZZ> 
Remove the file. 

rm exer4<CR> 



Exercise 5 

5-1. Type: 



5-2. Type: 



5-3. Type: 
5-4. Type: 



vi exer2<CR> 
<8G> 

<cc> END OF FILE <ESC> 

<1G> 
<8"zyy> 
<G> 
<"zp> 

<8G> 

<cc> 8 is great<ESC> 

<G> 

<2w> 

<cw> 

EXERCISE<ESC> 

<2b> 

<cw> 

TO<ESC> 
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Exercise 6 

6-1. Type: 

vi exer6<CR> 

<a> (append several lines of text) 
<ESC> 

Turn off the terminal. 

Turn on the terminal. 
Log in on your UMIPS system. Type: 
vi — r exer6<CR> 
swq<CR> 

vi exerl exer2<CR> 
sw<CR> 
:n<CR> 

:w junk<CR> 
<ZZ> 

vi exer*<CR> 

(Response:) 

8 files to edit (vi calls all files with names that begin with exer.) 
<ZZ> 

<zz> 

view exer4<CR> 
<~f> 
«Td> 
«Cb> 
<"u> 
:q<CR> 



6-2. Type: 



6-3. Type: 



6-4. Type: 
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ii USER'S GUIDE 



Introduction 



This chapter describes how to use the UMIPS system shell to do routine tasks. For 
example, it shows you how to use the shell to manage your files, to manipulate file 
contents, and to group commands together to make programs the shell can execute 
for you. 

The chapter has two major sections. The first section, "Shell Command Language," 
covers in detail using the shell as a command interpreter. It tells you how to use shell 
commands and characters with special meanings to manage files, redirect standard 
input and output, and execute and terminate processes. The second section, "Shell 
Programming," covers in detail using the shell as a programming language. It tells you 
how to create, execute, and debug programs made up of commands, variables, and 
programming constructs like loops and case statements. Finally, it tells you how to 
modify your login environment. 

The chapter offers many examples. You should login to your UMIPS system and 
recreate the examples as you read the text. As in the other examples in this guide, 
different type (bold, italic, and constant width) is used to distinguish your input 
from the UMIPS system's output. See "Notation Conventions" in the Preface for 
details. 

In addition to the examples, there are exercises at the end of both the "Shell Com- 
mand Language" and "Shell Programming" sections. The exercises can help you 
better understand the topics discussed. The answers to the exercises are at the end of 
the chapter. 



NOTE 



Your UMIPS system might not have all commands referenced in this chapter. If you 
cannot access a command, check with your system administrator. 



If you want an overview of how the shell functions as both command interpreter and 
programming language, see Chapters 1 and 4 before reading this chapter. Also, refer 
to Appendix E, Summary of Shell Command Language. 
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This section introduces commands and, more importantly, some characters with spe- 
cial meanings that let you 

* find and manipulate a group of files by using pattern matching 
m run a command in the background or at a specified time 

■ run a group of commands sequentially 

v redirect standard input and output from and to files and other commands 

* terminate processes 

It first covers the characters having special meanings to the shell and then covers the 
commands and notation for carrying out the tasks listed above. For your conveni- 
ence, Figure 74 summarizes the characters with special meanings discussed in this 
chapter. 
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Character 



Function 



* 9 



?[ 1 



< 
» 



metacharacters that provide a shortcut for specifying 
file names by pattern matching 

places commands in background mode, leaving your 
terminal free for other tasks 

separates multiple commands on one command line 

turns off the meaning of special characters such as * , 
?, [], ft, ;,>,<, and|. 

single quotes turn off the delimiting meaning of a 
space and the special meaning of all special characters 

double quotes turn off the delimiting meaning of a 
space and the special meaning of all special characters 
except $ and s 

redirects output of a command into a file (replaces 
existing contents) 

redirects input for a command to come from a file 

redirects output of a command to be added to the end 
of an existing file 

creates a pipe of the output of one command to the 
input of another command 

grave accents allow the output of a command to be 
used directly as arguments on a command line 

used with positional parameters and user-defined vari- 
ables; also used as the default shell prompt symbol 



Figure 7-1: Characters with Special Meanings in the Shell Language 



Metacharacters 

Metacharacters, a subset of the special characters, represent other characters. They 
are sometimes called wild cards, because they are like the joker in card games that 
can be used for any card. The metacharacters * (asterisk), ? (question mark), and [ ] 
(brackets) are discussed here. 

These characters are used to match file names or parts of file names, thereby simplify- 
ing the task of specifying files or groups of files as command arguments. (The files 
whose names match the patterns formed from these metacharacters must already 
exist.) This is known as file name expansion. For example, you may want to refer to 
all file names containing the letter "a", all file names consisting of five letters, and so 
on. 
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The Metacharacter That Matches All Characters: the Asterisk (*) 

The asterisk (*) matches any string of characters, including a null (empty) string. 
You can use the * to specify a full or partial file name. The * alone refers to all the 
file and directory names in the current directory. To see the effect of the *, try it as 
an argument to the echo(l) command. Type: 

echo *<CR> 

The echo command displays its arguments on your screen. Notice that the system 
response to echo * is a listing of all the file names in your current directory. How- 
ever, the file names are displayed horizontally rather than in vertical columns such as 
those produced by the Is command. 

Figure 7-2 summarizes the syntax and capabilities of the echo command. 





Command Recap 




echo - write any arguments to the output 


command 


options arguments 


echo 


none any character(s) 


Description: 


echo writes arguments, which are separated by 
blanks and ended with <CR>, to the output. 


Remarks: 


In shell programming, echo is used to issue 
instructions, to redirect words or data into a 
file, and to pipe data into a command. All 
these uses will be discussed later in this 
chapter. 



Figure 7-2: Summary of the echo Command 




The * is a powerful character, For example, if you type rm * you will erase all the 
files in your current directory. Be very careful how you use it! 



For another example, say you have written several reports and have named them 
report, report! , reportla, reportlb.01, re port 25, and report316. By typing report!* 
you can refer to all files that are part of reportl, collectively. To find out how many 
reports you have written, you can use the Is command to list all files that begin with 
the string "report," as shown in the following example. 
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$ Is report*<CR> 

report 

reportl 

reportla 

report lb. 01 

report 2 5 

report316 

$ 

The * matches any characters after the string "report," including no letters at all. 
Notice that * matches the files in numerical and alphabetical order. A quick and easy 
way to print the contents of your report files in order on your screen is by typing the 
following command: 

pr report*<CR> 

Now try another exercise. Choose a character that all the file names in your current 
directory have in common, such as a lower case "a". Then request a listing of those 
files by referring to that character. For example, if you choose a lower case "a", type 
the following command line: 

Is *a*<CR> 

The system responds by printing the names of all the files in your current directory 
that contain a lower case "a". 

The * can represent characters in any part of the file name. For example, if you 
know that several files have their first and last letters in common, you can request a 
list of them on that basis. For such a request, your command line might look like 
this: 

Is F*E<CR> 

The system response will be a list of file names that begin with F, end with E, and are 
in the following order: 

F123E 
FATE 
FE 

Fig3.4E 

The order is determined by the ASCII sort sequence: (1) numbers; (2) upper case 
letters; (3) lower case letters. 

The Metacharacter That Matches One Character: the Question Mark 
(?) 

The question mark (?) matches any single character of a file name. Let's say you 
have written several chapters in a* book that has twelve chapters, and you want a list 
of those you have finished through Chapter 9. Use the Is command with the ? to list 
all chapters that begin with the string "chapter" and end with any single character, as 
shown below: 
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$ is chapter?<CR> 

chapter 1 
chapters 
chapter? 
chapters 
$ 

The system responds by printing a list of all file names that match. 

Although ? matches any one character, you can use it more than once in a file name. 
To list the rest of the chapters in your hook ? type: 

Is chapter??<CR> 

Of course, if you want to list all the chapters in the current directory, use the *: 
Is chapter* 

Using the * or ? to Correct Typing Errors 

Suppose you use the mv(l) command to move a file, and you make an error and enter 
a character in the file name that is not printed on your screen. The system incor- 
porates this non-printing character into the name of your file and subsequently 
requires it a?s part of the file name. If you do not include this character when you 
enter the file name on a command line, you get an error message, You can use * or ? 
to match the file name with the non-printing character apd rename it to the correct 
name. . 

Try the following example. 

1, Make a very short file called trial. 

2, Type: mv trial tr*aH*g>l<CR> 

(Remember ». to type <*g> you must hold down the CONTROL key and press 
the g key.) 

3. Type; Is trIall<CR> 

The system will respond with an error message: 

$ Is triait<CR> 

, ' triall? no/ moh file or. directory ■ 

4. Type: Is trlaI?l<CR> 

The system will respond with the file nan^e trial! (including the non-printing 
character), verifying that this file exists . Use the ? again to correct the file 

.name, 

$ mv trial?! triall<CR> 
$ Is triall<CR> 

triall 

: $ 
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The Metacharacters That Match One of a Set: Brackets ([ ]) 

Use brackets ([ ]) when you want the shell to match any one of several possible char- 
acters that may appear in one position in the file name. For example, if you include 
[erf] as part of a file name pattern, the shell will look for file names that have the 
letter "c", the letter "r", or the letter "f" in the specified position, as the following 
example shows. 

$ Is [crf]at<CR> 

cat 
fat 
rat 
$ 

This command displays all file names that begin with the letter "c", "r", or "f" and end 
with the letters "at". Characters that can be grouped within brackets in this way are 
collectively called a "character class". 

Brackets can also be used to specify a range of characters, whether numbers or 
letters. For example, if you specify 

chapter[l-5] 

the shell will match any files named chapter 1 through chapters. This is an easy way 
to handle only a few chapters at a time. 

Try the pr command with an argument in brackets: 

$ pr chapter [2-4] <CR> 

This command will print the contents of chapter2, chapter3, and chapter4, in that 
order, on your terminal. 

A character class may also specify a range of letters. If you specify [A-Z], the shell 
will look only for upper case letters; if [a-z], only lower case letters. 

The uses of the metacharacters are summarized in Figure 7-3. Try out the metachar- 
acters on the files in your current directory. 



Character 


Function 




matches any string of characters, including an empty 
(null) string 


? 


matches any single character 


[] 


matches one of the sequence of characters specified 
within the brackets 


[-] 


matches one of the range of characters specified 



Figure 7-3: Summary of Metacharacters 
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Special Characters 

The shell language has other special characters that perform a variety of useful func- 
tions. Some of these additional special characters are discussed in this section; oth- 
ers are described in the next section, "Input and Output Redirection." 

Running a Command in Background: the Ampersand (&) 

Some shell commands take considerable time to execute. The ampersand (&) is used 
to execute commands in background mode, thus freeing your terminal for other tasks. 
The general format for running a command in background mode is 

command &<CR> 



NOTE 



You should not run interactive shell commands, for example read (see "Using the 
read Command" in this chapter), in the background. 



In the example below, the shell is performing a long search in background mode. 
Specifically, the grep(l) command is searching for the string "delinquent" in the file 
accounts.) Notice the & is the last character of the command line: 

$ grep delinquent accounts &<CR> 

21940 
$ 

When you run a command in the background, the UMIPS system outputs a process 
number; 21940 is the process number in the example. You can use this number to 
stop the execution of a background command. (Stopping the execution of processes 
is discussed in the "Executing and Terminating Processes" section.) The prompt on 
the last line means the terminal is free and waiting for your commands; grep has 
started running in background . 

Running a command in background affects only the availability of your terminal; it 
does not affect the output of the command. Whether or not a command is run in 
background, it prints its output on your terminal screen, unless you redirect it to a 
file. (See "Redirecting Output," later in this chapter, for details.) 

If you want a command to continue running in background after you log off, you can 
submit it with the nohup(l) command. (This is discussed in "Using the nohup Com- 
mand," later in this chapter.) 

Executing Commands Sequentially: the Semicolon (;) 

You can type two or more commands on one line as long as each pair is separated by 
a semicolon (;) , as follows: 

commandl; command2; command3<CR> 

The UMIPS system executes the commands in the order that they appear in the line 
and prints all output on the screen. This process is called sequential execution. 

Try this exercise to see how the ; works. First, type 

cd; pwd; ls<CR> 

The shell executes these commands sequentially: 
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1 . cd changes your location to your login directory 

2 . pwd prints the full path name of your current directory 

3 . Is lists the files in your current directory 

If you do not want the system's responses to these commands to appear on your 
screen, refer to "Redirecting Output" for instructions. 

Turning Off Special Meanings: the Backslash (\) 

The shell interprets the backslash (\) as an escape character that allows you to turn 
off any special meaning of the character immediately after it. To see how this works, 
try the following exercise. Create a two-line file called trial that contains the follow- 
ing text: 

The all * game 

was held in Summit . 

Use the grep command to search for the asterisk in the file, as shown in the following 
example: 

$ grep \* trial<CR> 

The all * game 
$ 

The grep command finds the * in the text and displays the line in which it appears. 
Without the \, the * would be a metacharacter to the shell and would match all file 
names in the current directory. 

Turning Off Special Meanings: Quotes 

Another way to escape the meaning of a special character is to use quotation marks. 
Single quotes ('...') turn off the special meaning of any character. Double quotes 
("...") turn off the special meaning of all characters except $ and * (grave accent), 
which retain their special meanings within double quotes. An advantage of using 
quotes is that numerous special characters can be enclosed in the quotes; this can be 
more concise than using the backslash. 

For example, if your file named trial also contained the line 

He really wondered why? Why??? 

you could use the grep command to match the line with the three question marks as 
follows: 

$ grep *???* trial<CR> 

He really wondered why? Why??? 

$ 

If you had instead entered the command 
grep ??? trial<CR> 

the three question marks would have been used as shell metacharacters and matched 
all file names of length three. 



SHELL TUTORIAL 7-9 



Shall Command Language 



Using Quotes to Turn Off the Meaning of a Space 

A common use of quotes as escape characters is for turning off the special meaning 
of the blank space. The shell interprets a space on a command line as a delimiter 
between the arguments of a command. Both single and double quotes allow you to 
escape that meaning. 

For example, to locate two or more words that appear together in text, make the 
words a single argument (to the grep command) by enclosing them in quotes. To find 
the two words "The all" in your file trial, enter the following command line: 

$ grep The air trial<CR> 

The all * game 
$ 

grep finds the string "The all" and prints the line that contains it. What would happen 
if you did not put quotes around that string? 

The ability to escape the special meaning of a space is especially helpful when you are 
using the banner(l) command. This command prints a message across a terminal 
screen in large, poster size letters. 

To execute banner, specify a message consisting of one or more arguments (in this 
case usually words), separated on the command line by spaces. The banner will use 
these spaces to delimit the arguments and print each argument on a separate line. 

To print more than one argument on the same line, enclose the words, together, in 
double quotes. For example, to send a birthday greeting to another user, type: 

banner happy birthday to you<CR> 

The command prints your message as a four-line banner. Now print the same mes- 
sage as a three-line banner. Type: 

banner happy birthday "to you"<CR> 

Notice that the words "to" and "you" now appear on the same line. The space 
between them has lost its meaning as a delimiter. 

Figure 7-4 summarizes the syntax and capabilities of the banner command. 
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Command Recap 




banner — make posters 


command 


options arguments 


banner 


none characters 


Description: 


banner displays up to ten characters in large 
letters 


Remarks: 


Later in this chapter you will learn how to 
redirect the banner command into a file to be 
used as a poster. 



Figure 7-4: Summary of the banner Command 



Input and Output Redirection 

In the UMIPS system, some commands expect to receive their input from the key- 
board (standard input) and most commands display their output at the terminal (stan- 
dard output). However, the UMIPS system lets you reassign the standard input and 
output to other files and programs. This is known as redirection. With redirection, 
you can tell the shell to 

■ take its input from a file rather than the keyboard 

■ send its output to file rather than the terminal 

■ use a program as the source of data for another program 

You use a set of operators, the less than sign (<), the greater than sign (>), two 
greater than signs (»), and the pipe (|) to redirect input and output. 

Redirecting Input: the < Sign 

To redirect input, specify a file name after a less than sign (<) on a command line: 

command < file<CR> 

For example, assume that you want use the mail(l) command (described in Chapter 
8) to send a message to another user with the login colleague and that you already 
have the message in a file named report. You can avoid retyping the message by 
specifying the file name as the source of input: 

mail colleague < report<CR> 
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Redirecting Output to a File: the > Sign 

To redirect output, specify a file name after the greater than sign (>) on a command 
line; 

command > ftle<CR> 



If you redirect output to a file that already exists, the output of your command will 
overwrite the contents of the existing file. 



Before redirecting the output of a command to a particular file, make sure that a file 
by that name does not already exist, unless you do not mind losing it. Because the 
shell does not allow you to have two files of the same name in a directory, it will 
overwrite the contents of the existing file with the output of your command if you 
redirect the output to a file with the existing file's name. The shell does not warn you 
about overwriting the original file. 

To make sure there is no file with the name you plan to use, run the Is command, 
specifying your proposed file name as an argument. If a file with that name exists, Is 
will list it; if not, you will receive a message that the file was not found in the current 
directory. For example, checking for the existence of the files temp and junk would 
give you the following output. 

$ Is temp<CR> 
temp 

$ Is junk<CR> 

junk: no such file or directory 

$ 

This means you can name your new output file junk, but you cannot name it temp 
unless you no longer want the contents of the existing temp file. 

Appending Output to an Existing File: the » Symbol 

To keep from destroying an existing file, you can also use the double redirection sym- 
bol (»), as follows: 

command » flle<CR> 

This appends the output of a command to the end of the file file. If file does not 
exist, it is created when you use the >> symbol this way. 

The following example shows how to append the output of the cat command to an 
existing file. First, the cat command is first executed on both files without output 
redirection to show their respective contents. Then the contents of trial2 are added 
after the last line of triall by executing the cat command on trial2 and redirecting the 
output to triall. 
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$ cat triall<CR> 

This is the first line of triall . 
Hello. 

This is the last line of triall. 
$ 

$ cat trial2<CR> 

This is the beginning of trial2 . 
Hello. 

This is the end of trial2. 
$ 

$ cat trial2 » triall<CR> 
$ cat triall<CR> 

This is the first line of triall . 
Hello. 

This is the last line of triall . 
This is the beginning of trial2 . 
Hello . 

This is the end of trial2 . 
$ 



Useful Applications of Output Redirection 

Redirecting output is useful when you do not want it to appear on your screen 
immediately or when you want to save it. Output redirection is also especially useful 
when you run commands that perform clerical chores on text files. Two such com- 
mands are spell and sort. 

The spell Command 

The spell program compares every word in a file against its internal vocabulary list 
and prints a list of all potential misspellings on the screen. If spell does not have a 
listing for a word (such as a person's name), it will report that as a misspelling, too. 

Running spell on a lengthy text file can take a long time and may produce a list of 
misspellings that is too long to fit on your screen, spell prints all its output at once; if 
it does not fit on the screen, the command scrolls it continuously off the top until it 
has all been displayed. A long list of misspellings will roll off your screen quickly and 
may be difficult to read. 

You can avoid this problem by redirecting the output of spell to a file. In the follow- 
ing example, spell searches a file named memo and places a list of misspelled words 
in a file named misspell: 

$ spell memo > misspell<CR> 

Figure 7-5 summarizes the syntax and capabilities of the spell command. 
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Command Recap 




spell — find spelling errors 


command 


options arguments 


spell 


available* file 


Description: 


spell collects words from a specified file or 
files and looks them up in a spelling list. 
Words that are not on the spelling list are 
displayed on your terminal. 


Options: 


spell has several options, including one for 
checking British spellings. 


Remarks: 


The list of misspelled words can be 
redirected into a file. 



* See the spell(l) manual page in the User's Reference Manual for all available options 
and an explanation of their capabilities. 

Figure 7-5: Summary of the spell Command 



The sort Command 

The sort command arranges the lines of a specified file in alphabetical order (see 
Chapter 3 for details). Because users generally want to keep a file that has been 
alphabetized, output redirection greatly enhances the value of this command. 

Be careful to choose a new name for the file that will receive the output of the sort 
command (the alphabetized list). When sort is executed, the shell first empties the 
file that will accept the redirected output. Then it performs the sort and places the 
output in the blank file. If you type 

sort list > list<CR> 

the shell will empty list and then sort nothing into list. 

Combining Background Mode and Output Redirection 

Running a command in background does not affect the command's output; unless it is 
redirected, output is always printed on the terminal screen. If you are using your ter- 
minal to perform other tasks while a command runs in background, you will be inter- 
rupted when the command displays its output on your screen. However, if you 
redirect that output to a file, you can work undisturbed. 

For example, in the "Special Characters" section you learned how to execute the grep 
command in background with &. Now suppose you want to find occurrences of the 
word "test" in a file named schedule. Run the grep command in background and 
redirect its output to a file called testfile: 

$ grep test schedule > testfile &<CR> 
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You can then use your terminal for other work and examine testfile when you have 
finished it. 

Redirecting Output to a Command: the Pipe ( | ) 

The | character is called a pipe. Pipes are powerful tools that allow you to take the 
output of one command and use it as input for another command without creating 
temporary files. A multiple command line created in this way is called a pipeline. 

The general format for a pipeline is: 

commandl \ command! \ commands. . . <CR> 

The output of commandl is used as the input of commandl. The output of com- 
mand! is then used as the input for commands. 

To understand the efficiency and power of a pipeline, consider the contrast between 
two methods that achieve the same results. 

■ To use the input/output redirection method, run one command and redirect its 
output to a temporary file. Then run a second command that takes the con- 
tents of the temporary file as its input. Finally, remove the temporary file after 
the second command has finished running. 

■ To use the pipeline method, run one command and pipe its output directly into 
a second command. 

For example, say you want to mail a happy birthday message in a banner to the owner 
of the login david. Doing this without a pipeline is a three-step procedure. You must 

1 . Enter the banner command and redirect its output to a temporary file: 

banner happy birthday > message. tmp 

2. Enter the mail command using message.tmp as its input: 

mail david < message.tmp 

3. Remove the temporary file: 

rm message.tmp 

However, by using a pipeline you can do this in one step: 
banner happy birthday | mail david<CR> 

A Pipeline Using the cut and date Commands 

The cut and date commands provide a good example of how pipelines can increase 
the versatility of individual commands. The cut command allows you to extract part 
of each line in a file. It looks for characters in a specified part of the line and prints 
them. To specify a position in a line, use the — c option and identify the part of the 
file you want by the numbers of the spaces it occupies on the line, counting from the 
left-hand margin. 
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For example, say you want to display only the dates from a file called birthdays. The 
file contains the following list: 

Anne 12/26 
Klaus 7/4 
Mary 10/18 
Peter 11/9 
Nandy 4/23 
Sam 8/12 

The birthdays appear between the ninth and thirteenth spaces on each line. To 
display them, type: 

cut -c9-13 birthdays<CR> 

The output is shown below: 

12/26 

7/4 

10/18 

11/9 

4/23 

8/12 
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Figure 7-6 summarizes the syntax and capabilities of the cut command. 





Command Recap 


cut - 


cut out selected fields from each line of a file 


command 


options arguments 


cut 


-clist file 
-flist [~d] 


Description: 


cut extracts columns from a table or fields 
from each line of a file 


Options: 


— c lists the number of character positions 
from the left. A range of numbers such as 
characters 1—9 can be snecified bv — cl—9 

-f lists the field number from the left 
separated by a delimiter described by -d. 

-d gives the field delimiter for -f. The default 
is a space. If the delimiter is a colon, this 
would be specified by -d : . 


Remarks: 


If you find the cut command useful, you may 
also want to use the paste command and the 
split command. 



Figure 7-6: Summary of the cut Command 



The cut command is usually executed on a file. However, piping makes it possible to 
run this command on the output of other commands, too. This is useful if you want 
only part of the information generated by another command. For example, you may 
want to have the time printed. The date command prints the day of the week, date, 
and time, as follows: 

$ date<CR> 

Sat Dec 27 13:12:32 EST 1986 

Notice that the time is given between the twelfth and nineteenth spaces of the line. 
You can display the time (without the date) by piping the output of date into cut, 
specifying spaces 12—19 with the — c option. Your command line and its output will 
look like this: 

$ date | cut -cl2-19<CR> 

13:14:56 
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Figure 7-7 summarizes the syntax and capabilities of the date command. 



Command Recap 
date - display the date and time 


command 


options arguments 


date 


4~%m%d%¥* available* 
+%H%%M%S 


Descriptions 


date displays the current date and time on 
your terminal 


Options; 


+% followed by m (for month), d (for day), y (for 
year), H (for hour), M (for month), and S (for 
second) will echo these back to your terminal. 
You can add explanations such as: 

date '+%H:%M is the time' 


Remarks: 


If you are working on a small computer system 
of which you are both a user and the system 
administrator, you may be allowed to set the 
date and time using optional arguments to the 
date command. Check your reference manual 
for details. When working in a multiuser 
environment, the arguments are available only 
to the system administrator. 



See the date(l) manual page in the User's Reference Manual for all available options and 
an explanation of their capabilities. 



Figure 7-7: Summary of the date Command 



Substituting Output for an Argument 

The output of any command may be captured and used as arguments on a command 
line. This is done by enclosing the command in grave accents (\..*) and placing it on 
the command line in the position where the output .should be treated as arguments. 
This is known as command substitution. 

For example, you can substitute the output of the date and cut pipeline command 
used previously for the argument in a banner printout by typing the following com- 
mand line: 

$ banner date | cut -cl2-19 <CR> 

Notice the results: the system prints a banner with the current time. 
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The "Shell Programming" section in this chapter shows you how you can also use the 
output of a command line as the value of a variable. 



Executing and Terminating Processes 

This section discusses the following topics: 

■ how to schedule commands to run at a later time by using the batch or at com- 
mand 

■ how to obtain the status of active processes 

■ how to terminate active processes 

■ how to keep background processes running after you have logged off 

Running Commands at a Later Time With the batch and at Commands 

The batch and at commands allow you to specify a command or sequence of com- 
mands to be run at a later time. With the batch command, the system determines 
when the commands run; with the at command, you determine when the commands 
run. Both commands expect input from standard input (the terminal); the list of 
commands entered as input from the terminal must be ended by pressing <"d> 
(control-d). 

The batch command is useful if you are running a process or shell program that uses 
a large amount of system time. The batch command submits a batch job (containing 
the commands to be executed) to the system. The job is put in a queue, and runs 
when the system load falls to an acceptable level. This frees the system to respond 
rapidly to other input and is a courtesy to other users. 

The general format for batch is: 

batch<CR> 

first command<CR> 



last command<CR> 
<Td> 

If there is only one command to be run with batch, you can enter it as follows: 

batch commandJHne<CR> 
<Td> 

The next example uses batch to execute the grep command at a convenient time. 
Here grep searches all files in the current directory and redirects the output to the file 
dol.file. 

$ batch grep dollar * > dol-file<CR> 
<~d> 

job 155223141. b at Sun Dec 7 11:14:54 1986 
$ 

After you submit a job with batch, the system responds with a job number, date, and 
time. This job number is not the same as the process number that the system gen- 
erates when you run a command in the background. 
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Figure 7-8 summarizes the syntax and capabilities of the batch Command. 



Command Recap 
batch — execute commands at a later time 



command options input 



hatch none commandjines 



Description: batch submits a batch job, which is placed in a 
queue and executed when the load on the sys- 
tem falls to an acceptable level. 

Remarks: The list of commands must end with a <"d> 

(control-d). 



Figure 7-8: Summary of the batch Command 



The at command allows you to specify an exact time to execute the commands. The 
general format for the at command is 

at time<CR> 

first command<CR> 



last command<CR> 
<~d> 

The time argument consists of the time of day and, if the date is not today, the date. 

The following example shows how to use the at command to mail a happy birthday 
banner to login emily on her birthday: 

$ at 8:15am Feb 27<CR> 

banner happy birthday | mail emily<CR> 

<~d> 

job 453400603 .a at Thurs Feb 27 08:15:00 1986 
$ 

Notice that the at command, like the batch command, responds with the job number, 
date, and time. 

If you decide you do not want to execute the commands currently waiting in a batch 
or at job queue, you can erase those jobs by using the -r option of the at command 
with the job number. The general format is 

at -r jobnumber<CR> 
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Try erasing the previous at job for the happy birthday banner. Type in: 

at -r 453400603.a<CR> 

If you have forgotten the job number, the at -I command will give you a list of the 
current jobs in the batch or at queue, as the following example shows: 

$ at -!<CR> 

user = mylogitl 168302040. a at Sat Nov 29 13:00:00 1986 
user = mylogitl 453400603. a at Fri Feb 27 08:15:00 1987 
$" 

Notice that the system displays the job number and the time the job will run. 

Using the at command, mail yourself the file memo at noon, to tell you it is lunch 
time. (You must redirect the file into mail unless you use the "here document," 
described in the "Shell Programming" section.) Then try the at command with the -1 
option: 

$ at 12:00pm<CR> 

mail mylogin < memo<CR> 

<Td> 

job 263131754. a at Jun 30 12:00:00 1986 
$ 

$ at -KCR> 

user = mylogin 263131754. a at Jun 30 12:00:00 1986 
$ 
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Figure 7-9 summarizes the syntax and capabilities of the at command. 





Command Recap 




at - execute commands at a specified time 


command 


options arguments 


at 


— r time (date) 
—1 jobnumber 


Description: 


Executes commands at the time specified. 
You can use between one and four digits, and 
am or pm to show the time. To specify the 
date, give a month name followed by the 
number for the day. You do not need to enter 
a date if you want your job to run the same 
day. See the at(l) manual page in the User's 

RpfpYPYicp h/fnnunl for otfipr Hf*faii1t timpe 

ixvytf tftl/C IrX %AI HAilAl LkJM, Will CI UwlaUll lllllCb. 


Options: 


The -r option with the job number removes 
previously scheduled jobs. 

The -1 option (no arguments) reports the job 
number and status of all scheduled at and 
batch jobs. 


Remarks: 


Examples of how to specify times and dates 
with the at command: 

at 08:15am Feb 27 
at 5:14pm Sept 24 



Figure 7-9: Summary of the at Command 



Obtaining the Status of Running Processes 

The ps command gives you the status of all the processes you are currently running. 
For example, you can use the ps command to show the status of all processes that 
you run in the background using & (described in the earlier section "Special Charac- 
ters"). 

The next section, "Terminating Active Processes," discusses how you can use the PID 
(process identification) number to stop a command from executing. A PID is a 
number from 1 to 30,000 that the UMIPS system assigns to each active process. 

In the following example, grep is run in the background, and then the ps command is 
issued. The system responds with the process identification (pid) and the terminal 
identification (tty) number. It also gives the cumulative execution time for each pro- 
cess (time), and the name of the command that is being executed (COMMAND) . 



7-22 USER'S GUIDE 



Shell Command Language 



$ grep word * > temp &<CR> 

28223 
$ 

$ ps<CR> 

PID TTY TIME COMMAND 

28124 ttylOOsOO sh 

28223 ttyl00:04 grep 

28224 ttyl00:04 ps 
$ 

Notice that the system reports a PID number for the grep command, as well as for 
the other processes that are running: the ps command itself, and the sh (shell) com- 
mand that runs while you are logged in. The shell program sh interprets the shell 
commands and is discussed in Chapters 1 and 4. 

Figure 7-10 summarizes the syntax and capabilities of the ps command. 





Command Recap 




ps — report process status 


command 


options arguments 


ps 


several* none 


Description: 


ps displays information about active processes. 


Options: 


Several. If none are specified, ps displays the 
status of all active processes you are running. 


Remarks: 


Gives you the PID (process ID). This is 
needed to kill a process (stop the process from 
executing). 



See the ps(l) manual page in the User's Reference Manual for all available options and 
an explanation of their capabilities. 



Figure 7-10: Summary of the ps Command 



Terminating Active Processes 

The kill command is used to terminate active shell processes. The general format for 
the kill command is 

kill P/D<CR> 

You can use the kill command to terminate processes that are running in background. 
Note that you cannot terminate background processes by pressing the BREAK or 
DELETE key. 
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The following example shows how you can terminate the grep command that you 
started executing in background in the previous example. 

$ kill 28223<CR> 

28223 Terminated 
$ 

Notice the system responds with a message and a $ prompt, showing that the process 
has been killed. If the system cannot find the PID number you specify, it responds 
with an error message: 

kill: 28223 :No such process 
Figure 7-11 summarizes the syntax and capabilities of the kill command. 





Command Recap 




kill - terminate a process \ 


command 


options arguments 


kill 


available* job number or PID 


Description: 


kill terminates the process specified by the 




PID number. 



See the kill(l) manual page in the User's Reference Manual for all available options and 
an explanation of their capabilities. 

Figure 7-11: Summary of the kill Command 



Using the nohup Command 

All processes are killed when you log off. If you want a background process to con- 
tinue running after you log off, you must use the nohup command to submit that 
background command. 

To execute the nohup command, follow this format: 

nohup command &<CR> 

Notice that you place the nohup command before the command you intend to run as 
a background process. 

For example, say you want the grep command to search all the files in the current 
directory for the string "word" and redirect the output to a file called word.list, and 
you wish to log off immediately afterward. Type the command line as follows: 

nohup grep word * > word.list & <CR> 

You can terminate the nohup command by using the kill command. Figure 7-12 sum- 
marizes the syntax and capabilities of the nohup command. 
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Command Recap 


nohup -~ prevents interruption of command execution by hang ups 


command 


options arguments 


nohup 


none command line 


Description; 


Executes a command line, even if you hang up 
or quit the system. 



Figure 7-12: Summary of the nohup Command 



Now that you have mastered these basic shell commands and notations, use them in 
your shell programs! The exercises that follow will help you practice using shell com- 
mand language. The answers to the exercises are at the end of the chapter. 
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1-1. What happens if you use an * (asterisk) at the beginning of a file name? Try 
to list some of the files in a directory using the * with the last letter of one of 
your file names. What happens? 

1-2. Try the following two commands; enter them as follows: 

cat[0-9]*<CR> 
echo *<CR> 

1-3. Is it acceptable to use a ? at the beginning or in the middle of a file name 
generation? Try it. 

1-4. Do you have any files that begin with a number? Can you list them without 

listing the other files in your directory? Can you list only those files that begin 
with a lower case letter between a and m? (Hint: use a range of numbers or 
letters in [ ]). 

1-5. Is it acceptable to place a command in background mode on a line that is exe- 
cuting several other commands sequentially? Try it. What happens? (Hint: 
use ; and &.) Can the command in background mode be placed in any posi- 
tion on the command line? Try placing it in various positions. Experiment 
with each new character that you learn to see the full power of the character. 

1-6. Redirect the output of pwd and Is into a file by using the following command 
line: 

cd; pwd; Is; ed trial<CR> 

Remember, if you want to redirect both commands to the same file, you have 
to use the >> (append) sign for the second redirection. If you do not, you 
will wipe out the information from the pwd command. 

1-7. Instead of cutting the time out of the date response, try redirecting only the 

date, without the time, into banner. What is the only part you need to change 
in the time command line? 

banner 'date | cut -cl2-19'<CR> 
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You can use the shell to create programs — new commands. Such programs are also 
called "shell procedures." This section tells you how to create and execute shell pro- 
grams using commands, variables, positional parameters, return codes, and basic pro- 
gramming control structures. 

The examples of shell programs in this section are shown two ways. First, the cat 
command is used to display the contents of a file containing a shell program: 

$ cat testfile<CR> 
first command 



last command 
$ 

Second, the results of executing the shell program appear after a command line: 

$ testfile<CR> 
program^output 
$ 

You should be familiar with an editor before you try to create shell programs. Refer 
to the tutorials in Chapter 5 (for the ed editor) and Chapter 6 (for the vi editor). 



Shell Programs 

Creating a Simple Shell Program 

We will begin by creating a simple shell program that will do the following tasks, in 
order. 

■ print the current directory 

■ list the contents of that directory 

■ display this message on your terminal: "This is the end of the shell" program. 

Create a file called dl (short for directory list) using your editor of choice, and enter 
the following: 

#! /bin/sh<CR> 

pwd<CR> 

ls<CR> 

echo This is the end of the shell program. <CR> 

Now write and quit the file. You have just created a shell program! You can cat the 
file to display its contents, as the following example shows: 
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$ cat d!<CR> 

#! /bin/sh<CR> 

pwd 

Is 

echo This is the end of the shell program. 
$ 



The first line of the shell script tells the operating system that his file contains com- 
mands to be executed by the shell. It is a good idea to put this as the first line of all 
shell scripts. 

Executing a Shell Program 

One way to execute a shell program is to use the sh command. Type: 
sh dl<CR> 

The dl command is executed by sh, and the path name of the current directory is 
printed first, then the list of files in the current directory, and finally, the comment 
This is the end of the shell program. The sh command provides a good 
way to test your shell program to make sure it works. 

If dl is a useful command, you can use the chmod command to make it an executable 
file; then you can type dlby itself to execute the command it contains. The following 
example shows how to use the chmod command to make a file executable and then 
run the Is -1 command to verify the changes you have made in the permissions. 

$ chmod u+x dl<CR> 
$ Is -1<CR> 

total 2 

-rw- 1 login login 3661 Nov 210: 28 mbox 

-rwx— 1 login login 48 Nov 1510: 50 dl 

$ 

Notice that chmod turns on permission to execute (+x) for the user (u). Now dl is an 
executable program. Try to execute it. Type: 

dKCR> 

You get the same results as before, when you entered sh dl to execute it. For further 
details about the chmod command, see Chapter 3. 

Creating a bin Directory for Executable Files 

To make your shell programs accessible from all your directories, you can make a bin 
directory from your login directory and move the shell files to your bin. 

You must also set your shell variable PATH to include your bin directory: 

PATH=$PATH;$HOME/bin 

See "Variables" and "Using Shell Variables" in this chapter for more information 
about PATH. 

The following example will remind you which commands are necessary. In this exam- 
ple, dl is in the login directory. Type these command lines: 
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cd<CR> 
mkdir bin<CR> 
my dl bin/dKCR> 

Move to the bin directory and type the Is —1 command. Does dl still have execute 
permission? 

Now move to a directory other than the login directory, and type the following com- 
mand: 

dl<CR> 

What happened? 

Figure 7-13 summarizes your new shell program, dl. 

Shell Program Recap 

dl - display the directory path and directory contents (user defined) 

command arguments 

dl none 

Description: dl displays the output of the shell command 
pwd and Is. 

Figure 7-13: Summary of the dl Shell Program 



It is possible to give the bin directory another name; if you do so, you need to change 
your shell variable PATH again. 

Warnings about Naming Shell Programs 

You can give your shell program any appropriate file name. However, you should not 
give your program the same name as a system command. If you do, the system will 
execute your command instead of the system command. For example, if you had 
named your dl program mv, each time you tried to move a file, the system would have 
executed your directory list program instead of mv. 

Another problem can occur if you name the dl file Is, and then try to execute the file. 
You would create an infinite loop, since your program executes the Is command. 
After some time, the system would give you the following error message: 

Too many processes, cannot fork 

What happened? You typed in your new command, Is. The shell read and executed 
the pwd command. Then it read the Is command in your program and tried to exe- 
cute your Is command. This formed an infinite loop. 

UMIPS system designers wisely set a limit on how many times an infinite loop can 
execute. One way to keep this from happening is to give the path name for the 
system's Is command, /bin/Is, when you write your own shell program. 
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The following Is shell program would work: 



$ cat ls<CR> 

#!/bin/sh<CR> 

pwd 

/bin/Is 

echo This is the end of the shell program 

If you name your command Is, then you can only execute the system Is command by 
using its full path name, /bin/Is. 



Variables 

Variables are the basic data objects shell programs manipulate, other than files. Here 
we discuss three types of variables and how you can use them: 

■ positional parameters 

■ special parameters 

■ named variables 

Positional Parameters 

A positional parameter is a variable within a shell program whose value is set from an 
argument specified on the command line invoking the program. Positional parameters 
are numbered and are referred to with a preceding $: $1, $2, $3, and so on. 

A shell program may reference up to nine positional parameters. If a shell program 
is invoked on with a command line that appears like this: 

shell.prog ppl pp2 pp3 pp4 pp5 pp6 pp7 pp8 pp9<CR> 

then positional parameter $1 within the program will be assigned the value ppl, posi- 
tional parameter $2 within the program will be assigned the value pp2, and so on, 
when the shell program is invoked. 

Create a file called pp (short for positional parameters) to practice positional parame- 
ter substitution. Then enter the echo commands shown in the following example. 
Enter the command lines so that running the cat command on your completed file will 
produce the following output: 

$ cat pp<CR> 
#!/bin/sh<CR> 

echo The first positional parameter is: $1<CR> 
echo The second positional parameter is: $2<CR> 
echo The third positional parameter is: $3<CR> 
echo The fourth positional parameter is: $4<CR> 

$ 

If you execute this shell program with the arguments one, two, three, and four, you 
will obtain the following results (first you must make the shell program pp executable 
using the chmod command): 
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$ chmod u+x pp<CR> 

$ 

$ pp one two three four<CR> 

The first positional parameter is : one 
The second positional parameter is: two 
The third positional parameter is: three 
The fourth positional parameter is: four 
$ 

The following example shows the shell program bbday, which mails a greeting to the 
login entered in the command line: 

$ cat bbday<CR> 

#!/bin/sh<CR> 

banner happy birthday | mail $1 

Try sending yourself a birthday greeting. If your login name is sue, your command 
line will be: 

bbday sue<CR> 

Figure 7-14 summarizes the syntax and capabilities of the bbday shell program. 





Shell Program Recap 


bbday - 


mail a banner birthday greeting (user defined) 


command 


arguments 


bbday 


login 


Descriptions 


bbday mails the message happy birthday, in 
poster-sized letters, to the specified login. 



Figure 7-14: Summary of the bbday Command 



The who command lists all users currently logged in on the system. How can you 
make a simple shell program called whoson, that will tell you if the owner of a partic- 
ular login is currently working on the system? 

Type the following command line into a file called whoson: 

who | grep $1<CR> 

The who command lists all current system users, and grep searches the output of the 
who command for a line containing the string contained as a value in the positional 
parameter $1. 

Now try using your login as the argument for the new program whoson. For example, 
say your login is sue. When you issue the whoson command, the shell program sub- 
stitutes sue for the parameter $1 in your program and executes as if it were: 

who | grep sue <CR> 
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The output is shown on the following example: 

$ whoson sue<CR> 

sue tty26 Jan 24 13:35 

$ 

If the owner of the specified login is not currently working on the system, grep fails 
and the whoson prints no output. 

Figure 7-15 summarizes the syntax and capabilities of the whoson command. 





Shell Program Recap 


whoson - 


display login information if user is logged in (user defined) 


command 


arguments 


whoson 


login 


Description: 


If a user is on the system, whoson displays the user's 
login, the TTY number, and the time and date the 
user logged in, 



Figure 7-15: Summary of the whoson Command 



The shell allows a command line to contains 128 arguments. However, a shell pro- 
gram is restricted to referencing nine positional parameters, $1 through $9, at a given 
time. This restriction can be worked around using the shift command. The special 
parameter $*, described in the next section, can also be used to access the values of 
all command line arguments. 

Special Parameters 

$# This parameter, when referenced within a shell program, contains the number 
of arguments with which the shell program was invoked. Its value can be 
used anywhere within the shell program. 

Enter the command line shown in the following example in an executable shell pro- 
gram called get.num. Then run the cat command on the file: 

$ cat get.num<CR> 

#! /bin/sh<CR> 

echo The number of arguments is: $# 
$ 

The program simply displays the number of arguments with which it is invoked. For 
example: 

$ get.num test out this program<CR> 

The number of arguments is : 4 
$ 
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Figure 7-16 summarizes the get num shell program. 





Shell Program Recap 


get«num - 


count and display the number of arguments (user defined) 


command 


arguments 


get.num 


(character^string) 


Description: 


get.num counts the number of arguments given to the 
command and then displays the total. 


Remarks: 


This command demonstrates the special parameter 
<&& 



Figure 7-16: Summary of the get.num Shell Program 



$* This special parameter, when referenced within a shell program, contains a 
string with all the arguments with which the shell program was invoked, start- 
ing with the first. You are not restricted to nine parameters as with the posi- 
tional parameters $1 through $9. 

You can write a simple shell program to demonstrate $*. Create a shell program 
called show.param that will echo all the parameters. Use the command line shown in 
the following completed file: 

$ cat show.param<CR> 
#!/bin/sh<CR> 

echo The parameters for this command are: $* 

$ 

show.param will echo all the arguments you give to the command. Make 
show.param executable and try it out, using these parameters: 

Hello. How are you? 

$ show.param Hello. How are you?<CR> 

The parameters for this command are: Hello. How are you? 
$ 

Notice that show.param echoes "Hello. How are you?" Now try show.param using 
more than nine arguments: 

$ show.param one two 3 4 5 six 7 8 9 10 11<CR> 

The parameters for this command are: one two 3 4 5 six 

7 8 9 10 11 

$ 

Once again, show.param echoes all the arguments you give. The $* parameter can 
be useful if you use file name expansion to specify arguments to the shell command. 
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Use the file name expansion feature with your show.param command. For example, 
say you have several files in your directory named for chapters of a book: chapl, 
chap2, and so on, through chap7. show.param will print a list of all those files. 

$ show.param chap?<CR> 

The parameters for this command are : chapl chap2 chap3 

chap4 chap5 chap6 chap? 

$ 

Figure 7-17 summarizes the show.param shell program. 





Shell Program Recap 


show.param 


- display all positional parameters (user defined) 


command 


arguments 


show.param 


(any positional parameters) 


Description: 


show.param displays all the parameters. 


Remarks: 


If the parameters are file name generations, the com- 
mand will display each of those file names. 



Figure 7-17: Summary of the show.param Shell Program 



Named Variables 

Another form of variable that you can use within a shell program is a named variable. 
You assign values to named variables yourself. The format for assigning a value to a 
named variable is 

named_yariable = value< CR> 

Notice that there are no spaces on either side of the = sign. 

In the following example, varl is a named variable, and myname is the value or char- 
acter string assigned to that variable: 

varl=myname<CR> 

A $ is used in front of a variable name in a shell program to reference the value of 
that variable. Using the example above, the reference $varl tells the shell to substi- 
tute the value myname (assigned to varl), for any occurrence of the character string 
$varl. 

The first character of a variable name must be a letter or an underscore. The rest of 
the name can be composed of letters, underscores, and digits, As in shell program 
file names, it is not advisable to use a shell command name as a variable name. Also, 
the shell has reserved some variable names you should not use for your variables. A 
brief explanation of these reserved shell variable names follows: 
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■ CDPATH defines the search path for the cd command. 

■ HOME is the default variable for the cd command (home directory). 

■ IFS defines the internal field separators (normally the space, the tab, and the 
carriage return). 

■ LOGNAME is your login name. 

■ MAIL names the file that contains your electronic mail. 

■ PATH determines the search path used by the shell to find commands. 

■ PS1 defines the primary prompt (default is $). 

■ PS2 defines the secondary prompt (default is >). 

■ TERM identifies your terminal type. It is important to set this variable if you 
are editing with vi. 

■ TERMINFO identifies the directory to be searched for information about your 
terminal, for example, its screen size. 

■ TZ defines the time zone (default is EST5EDT). 

Many of these variables are explained in "Modifying Your Login Environment" later in 
this chapter. You can also read more about them on the sh(l) manual page in the 
User's Reference Manual. 

You can see the value of these variables in your shell in two ways. First, you can type 
echo %variablejname 

The system outputs the value of variable jname. Second, you can use the env(l) com- 
mand to print out the value of all defined variables in the shell. To do this, type env 
on a line by itself; the system outputs a list of the variable names and values. 

Assigning a Value to a Variable 

If you edit with vi, you know you can set the TERM variable by entering the following 
command line: 

TERM = terminaLname<CR> 

This is the simplest way to assign a value to a variable. 

There are several other ways to do this: 

■ Use the read command to assign input to the variable. 

■ Redirect the output of a command into a variable by using command substitu- 
tion with grave accents ( v ... v ). 

■ Assign a positional parameter to the variable. 

The following sections discuss each of these methods in detail. 

Using the read Command 

The read command used within a shell program allows you to prompt the user of the 
program for the values of variables. The general format for the read command is: 

read variable<CR> 

The values assigned by read to variable will be substituted for ^variable wherever it is 
used in the program. If a program executes the echo command just before the read 
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command, the program can display directions such as Type in .... The read 
command will wait until you type a character string, followed by a RETURN key, and 
then make that string the value of the variable. 

The following example shows how to write a simple shell program called num.please 
to keep track of your telephone numbers. This program uses the following commands 
for the purposes specified: 

echo to prompt you for a person's last name 

read to assign the input value to the variable name 

grep to search the file list for this variable 

Your finished program should look like the one displayed here: 

$ cat num»plea$e<CR> 
#!/bin/sh<CR> 

echo Type in the last name: 
read name 
grep $name list 
$ 

Create a file called list that contains several last names and phone numbers. Then try 
running num.please. 

The next example is a program called mknum, which creates a list, mknum includes 
the following commands for the purposes shown. 

■ echo prompts for a person's name 

■ read assigns the person's name to the variable name 

■ echo asks for the person's number 

■ read assigns the telephone number to the variable num 

■ echo adds the values of the variables name and num to the file list 

If you want the output of the echo command to be added to the end of list, you must 
use » to redirect it. If you use >, list will contain only the last phone number you 
added. 

Running the cat command on mknum displays the program's contents. When your 
program looks like this, you will be ready to make it executable (with the chmod com- 
mand): 

$ cat mknum<CR> 
#!/bin/sh<CR> 

echo Type in name 
read name 

echo Type in number 
read num 

echo $name $num >> list 
$ chmod u+x mknum<CR> 

$ 
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Try out the new programs for your phone list. In the next example, mknum creates a 
new listing for Mr. Niceguy. Then num.please gives you Mr. Niceguy's phone 
number: 

$ mknum<CR> 

Type in the name 

Mr. Niceguy<CR> 

Type in the number 

668-0007<CR> 

$ num.please<CR> 

Type in last name 

Niceguy<CR> 

Mr. Niceguy 668-0007 

$ 

Notice that the variable name accepts both Mr. and Niceguy as the value. 

Figures 7-18 and 7-19 summarize the mknum and num.please shell programs, respec- 
tively. 





Shell Program Recap 


mknum - place name and number on a phone list 


command 


arguments 


mknum 


(interactive) 


Description: 


Asks you for the name and number of a person and 
adds that name and number to your phone list. 


Remarks: 


This is an interactive command. 



Figure 7-18: Summary of the mknum Shell Program 
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num.please - display a person's name and number 


command 


arguments 


num.please 


(interactive) 


Description; 


Asks you for a person's last name, and then displays 
the person's full name and telephone number. 


Remarks; 


This is an interactive command. 



Figure 7-19: Summary of the num.please Shell Program 



Substituting Command Output for the Value of a Variable 

You can substitute a command's output for the value of a variable by using command 
substitution. This has the following format: 

variable = command *<CR> 

The output from command becomes the value of variable. 

In one of the previous examples on piping, the date command was piped into the cut 
command to get the correct time. That command line was the following: 

date | cut ^-cl2-19<CR> 

You can put this in a simple shell program called t that will give you the time. 

$ cat t<CR> 
#!/bin/sh<CR> 
times date | cut ~cl2-iy 
echo The time is: $time 

$ 

Remember there are no spaces on either side of the equal sign, Make the file execut- 
able, and you will have a program that gives you the time: 

$ chmod u+x t<CR> 
$ t<CR> 

The time is: 10: 36 
$ 
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Figure 7-20 summarizes your t program. 
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t - display the correct time 


command 


arguments 


t 


none 


Descriptions 


t gives you the correct time in hours and minutes. 



Figure 7-20: Summary of the t Shell Program 



Assigning Values with Positional Parameters 

You can assign a positional parameter to a named parameter by using the following 
format: 

var2 = $KCR> 

The next example is a simple program called simp.p that assigns a positional param- 
eter to a variable. The following example shows the commands in simp.p: 

$ cat simp.p<CR> 

#!/bin/sh<CR> 

varl=$l 

echo $varl 

$ 

Of course, you can also assign the output of a command that uses positional parame- 
ters to a variable, as follows: 

persons: who | grep $r<CR> 

In the next example, the program log.time keeps track of your whoson program 
results. The output of whoson is assigned to the variable person, and added to the 
file login.file with the echo command. The last echo displays the value of $person, 
which is the same as the output from the whoson command: 

$ cat log.time<CR> 
#!/bin/sh<CR> 
persons Vho | grep $r 
echo $person » login.file 
echo $person 
$ 

The system response to log.time is shown in the following example: 
$ log.time maryann<CR> 

maryann tty61 Apr 11 10:26 

$ 
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Figure 7-21 summarizes the legitime shell program. 





Shell Program Recap 


logotime - 


- log and display a specified login (user defined) 


command 


arguments 


log.time 


login 


Descriptions 


If the specified login is currently on the system, 
log.time places the line of information from the who 
command into the file login.file and then displays that 
line of information on your terminal. 



Figure 7-21: Summary of the log.time Shell Program 



Shell Programming Constructs 

The shell programming language has several constructs that give added flexibility to 

your programs: 

■ Comments let you document a program's function. 

■ The "here document" allows you to include within the shell program itself lines 
to be redirected to be the input to some command in the shell program. 

■ The exit command lets you terminate a program at a point other than the end 
of the program and use return codes. 

■ The looping constructs, for and while, allow a program to iterate through 
groups of commands in a loop. 

■ The conditional control commands, if and case, execute a group of commands 
only if a particular set of conditions is met. 

■ The break command allows a program to exit unconditionally from a loop. 



Comments 

You can place comments in a shell program in two ways. All text on a line following 
a # (pound) sign is ignored by the shell. The # sign can be at the beginning of a line, 
in which case the comment uses the entire line, or it can occur after a command, in 
which case the command is executed but the remainder of the line is ignored. The 
end of a line always ends a comment. The general format for a comment line is 

#comment<CR> 

For example, a program that contains the following lines will ignore them when it is 
executed: 
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# This program sends a generic birthday greeting. <CR> 

# This program needs a login as<CR> 

# the positional parameter. <CR> 

Comments are useful for documenting a program's function and should be included in 
any program you write. 

The here Document 

A "here document" allows you to place into a shell program lines that are redirected 
to be the input of a command in that program. It is a way to provide input to a com- 
mand in a shell program without needing to use a separate file. The notation consists 
of the redirection symbol « and a delimiter that specifies the beginning and end of 
the lines of input. The delimiter can be one character or a string of characters; the ! 
is often used. 

Figure 7-22 shows the general format for a here document. 



command < <delimiter<CR> 
...input lines*..<CR> 
delimiter<CR> 



Figure 7-22: Format of a Here Document 



In the next example, the program gbday uses a here document to send a generic birth- 
day greeting by redirecting lines of input into the mail command: 

$ cat gbday<CR> 

#! /bin/sh 
mail $1 <<! 

Best wishes to you on your birthday . 
$ 

When you use this command, you must specify the recipient's login as the argument 
to the command. The input included with the use of the here document is: 

Best wishes to you on your birthday 
For example, to send this greeting to the owner of login maiy, type: 

$ gbday mary<CR> 
Login mary will receive your greeting the next time she reads her mail messages: 

$ mail<CR> 

From mylogin Wed May 14 14 : 31 CDT 1986 
Best wishes to you on your birthday 
$ 
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Figure 7-23 summarizes the format and capabilities of the gbday command. 





Shell Program Reeap 


gbday * 


send a generic birthday greeting (user defined) 


command 


arguments 


gbday 


login 


Descriptions 


gbday sends a generic birthday greeting to the 
owner of the login specified in the argument. 



Figure 7-23: Summary of the gbday Command 



Using ed in a Shell Program 

The here document offers a convenient and useful way to use ed in a shell script. For 
example, suppose you want to make a shell program that will enter the ed editor, 
make a global substitution to a file, write the file, and then quit ed. The following 
example shows the contents of a program called ch.text which does these tasks. 

$ cat ch.text<CR> 

#! /bin/sh 

echo Type in the file name, 
read f ilel 

echo Type in the exact text to be changed . 
read old_text 

echo Type in the exact new text to replace the above . 

read newjtext 

ed - $filel <<! 

g/$old_text/s//$new_text/g 

w 

q 

$ 

Notice the - (minus) option to the ed command. This option prevents the character 
count from being displayed on the screen. Notice, also, the format of the ed com- 
mand for global substitution: 

g/old„text/s//new_text/g<CR> 

The program uses three variables: filel, oldjext, and newjtext. When the program is 
run, it uses the read command to obtain the values of these variables. The variables 
provide the following information: 

file the name of the file to be edited 

oldjtext the exact text to be changed 
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newjtext the new text 

Once the variables are entered in the program, the here document redirects the global 
substitution, the write command, and the quit command into the ed command. Try 
the new ch.text command. The following example shows sample responses to the 
program prompts: 

$ ch.text<CR> 

Type in the filename. 

memo<CR> 

Type in the exact text to be changed. 
Dear John:<CR> 

Type in the exact new text to replace the above. 
To whom it may concerns <CR> 
$ cat memo<CR> 

To whom it may concern: 
$ 

Notice that by running the cat command on the changed file, you could examine the 
results of the global substitution. 

Figure 7-24 summarizes the format and capabilities of the ch.text command. 



Figure 
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ch.text — change text in a file 


command 


arguments 


ch.text 


(interactive) 


Description: 


Replaces text in a file with new text. 


Remarks: 


This shell program is interactive. It will 
prompt you to type in the arguments. 


7-24: Summary of the ch.text Command 



If you want to become more familiar with ed, see Chapter 5, "Line Editor Tutorial 
(ed)." The stream editor sed can also be used in shell programming. You can find 
more information on the sed editor in the Editing Guide or Editing Utilities Guide. 

Return Codes 

Most shell commands issue return codes that indicate whether the command executed 
properly. By convention, if the value returned is 0 (zero) than the command executed 
properly; any other value indicates that it did not. The return code is not printed 
automatically, but is available as the value of the shell special parameter $?. 
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Checking Return Codes 

After executing a command interactively, you can see its return code by typing 
echo $? 

Consider the following example: 
$ eat hi 

This is file hi, 

$ echo $? 

0 

$ cat hello 

cat: cannot open hello 

$ echo $? 

2 

$ 

In the first case, the file hi exists in your directory and has read permis- 
sion for you. The cat command behaves as expected and outputs the contents of the 
file. It exits with a return code of 0, which you can see using the parameter $?. In 
the second case, the file either does not exist or does not have read permission for 
you. The cat command prints a diagnostic message and exits with a return code of 2. 

Using Return Codies With the exit Command 

A shell program normally terminates when the last command in the file is executed. 
However, you can use the exit command to terminate a program at some other point. 
Perhaps more importantly, you can also use the exit command to issue return codes 
for a shell program. F6r more information about exit, see the exit(2) manual page in 
the Programmer's Reference Manual. 

Looping 

In the previous examples in this chapter, the commands in shell programs have been 
executed in sequence. The for and while looping constructs allow a program to exe- 
cute a command or sequence of commands several times. 

The for Loop 

The for loop executes a sequence of commands once for each member of a list. It 
has the following format: 
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for variable<CR> 

in aJist„of„values<CR> 

do<CR> 

command i<CR> 
command 2<CR> 



last command<CR> 
done<CR> 



Figure 7-25: Format of the for Loop Construct 



For each iteration of the loop, the next member of the list is assigned to the variable 
given in the for clause. References to that variable may be made anywhere in the 
commands within the do clause. 

It is easier to read a shell program if the looping constructs are visually clear. Since 
the shell ignores spaces at the beginning of lines, each section of commands can be 
indented as it was in the above format. Also, if you indent each command section, 
you can easily check to make sure each do has a corresponding done at the end of the 
loop. 

The variable can be any name you choose. For example, if you call it var, then the 
values given in the list after the keyword in will be assigned in turn to var; references 
within the command list to $var will make the value available. If the in clause is 
omitted, the values for var will be the complete set of arguments given to the com- 
mand and available in the special parameter $*. The command list between the key- 
words do and done will be executed once for each value. 

When the commands have been executed for the last value in the list, the program 
will execute the next line below done. If there is no line, the program will end. 

The easiest way to understand a shell programming construct is to try an example. 
Create a program that will move files to another directory Include the following com- 
mands for the purposes shown: 

echo to prompt the user for a path name to the new directory. 

read to assign the path name to the variable path 

for variable to call the variable file; it can be referenced as $file in the 

command sequence. 

in list^ofjvalues to supply a list of values. If the in clause is omitted, the 

list of values is assumed to be $* (all the arguments 
entered on the command line). 

do command^sequence 

to provide a command sequence. The construct for this 
program will be: 
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do 

mv $file $path/$file<CR> 
done 

The following example shows the text for the shell program mv.file: 
$ cat mv.flle<CR> 

echo Please type in the directory path 
read path 
for file 

in memol memo 2 memo 3 

do 

mv $f ile $path/$f ile 
done 
$ 

In this program the values for the variable file are already in the program. To change 
the files each time the program is invoked, assign the values using positional parame- 
ters or the read command. When positional parameters are used, the in keyword is 
not needed, as the next example shows: 

$ cat mv.file<CR> 

echo type in the directory path 
read path 
for file 
do 

mv $f ile $path/$f ile 
done 
$ 

You can move several files at once with this command by specifying a list of file 
names as arguments to the command, (This can be done most easily using the file 
name expansion mechanism described earlier). 

Figure 7-26 summarizes the mv.file shell program. 
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mv.file 


- move files to another directory (user defined) 


command 


arguments 


mv.file 


filenames 
(interactive) 


Description: 


Moves files to a new directory. 


Remarks: 


This program requires file names to be given 
as arguments. The program prompts for the 
path to the new directory. 



Figure 7-26: Summary of mv.file Shell Program 



The while Loop 

Another loop construct, the while loop, uses two groups of commands. It will con- 
tinue executing the sequence of commands in the second group, the do. ..done list, as 
long as the final command in the first group, the while list, returns a status of true 
(meaning the command can be executed). 

The general format of the while loop is shown in Figure 7-27. 



while<CR> 

command 1<CR> 



last command<CR> 
do<CR> 

command 2<CR> 



last command<CR> 
done<CR> 



Figure 7-27: Format of the while Loop Construct 



For example, a program called enter .name uses a while loop to enter a list of names 
into a file. The program consists of the following command lines: 
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$ cat enter.name<CR> 

while 

read x 

do 

echo $x> >xf ile 
done 
$ 

With some added refinements, the program becomes: 
$ cat enter.name<CR> 

echo Please type in each person's name and then a <CR> 
echo Please end the list of names with a <~d> 
while read x 
do 

echo $x>>xf ile 
done 

echo xf ile contains the following names: 

cat xf ile 

$ 

Notice that after the loop is completed, the program executes the commands below 
the done. 

You used special characters in the first two echo command lines, so you must use 
quotes to turn off the special meaning. The next example shows the results of 
enter.name: 

$ enter.name < CR> 

Please type in each person's name and then a <CR> 

Please end the list of names with a <~d> 

Mary Lou<CR> 

Janice<CR> 

<~d> 

xf ile contains the following names : 

Mary Lou 

Janice 

$ 

Notice that after the loop completes, the program prints all the names contained in 
xfite. 

The Shell's Garbage Can: /dev/mill 

The file system has a file called /dev/null where you can have the shell deposit any 
unwanted output. 

Try out /dev/null by destroying the results of the who command. First, type in the 
who command. The response tells you who is on the system. Now, try the who com- 
mand, but redirect the output into /dev/null: 

who > /dev/null<CR> 

Notice that the system responded with a prompt. The output from the who command 
was placed in /dev/null and was effectively discarded. 



7-48 USER'S GUIDE 



Conditional Constructs 

if... then 

The if command tells the shell program to execute the then sequence of commands 
only if the final command in the if command list is successful. The if construct ends 
with the keyword fi. 

The general format for the if construct is shown in Figure 7-28. 



if<CR> 

commandl<CR> 



last command<CR> 
then<CR> 

command 1<CR> 



last command<CR> 

fl<CR> 



Figure 7-28: Format of the if.. .then Conditional Construct 



For example, a shell program called search demonstrates the use of the if.. .then con- 
struct, search uses the grep command to search for a word in a file. If grep is suc- 
cessful, the program will echo that the word is found in the file. Copy the search 
program (shown in the following example) and try it yourself: 

$ cat search<CR> 
#! /bin/sh 

echo Type in the word and the file name. 

read word file 

if grep $word $f ile 

then echo $word is in $f ile 

fi 
$ 

Notice that the read command assigns values to two variables. The first characters 
you type, up until a space, are assigned to word. The rest of the characters, including 
embedded spaces, are assigned to file. 

A problem with this program is the unwanted display of output from the grep com- 
mand. If you want to dispose of the system response to the grep command in your 
program, use the file /dev/null, changing the if command line to the following: 

if grep $word %file > /dev/null<CR> 

Now execute your search program. It should respond only with the message specified 
after the echo command. 
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if. ..then... else 



The if... then construction can also issue an alternate set of commands with else, when 
the if command sequence is false. It has the following general format: 



if<CR> 

commandl<CR> 



last command<CR> 
then<CR> 

commandl<CR> 



last command<CR> 
else^CR^ 

command 1<CR> 



last command<CR> 

fi<CR> 



Figure 7-29: Format of the if.. .then.. .else Conditional Construct 



if grep %word %file > /dev/null<CR> 

You can now improve your search command so it will tell you when it cannot find a 
word, as well as when it can. The following example shows how your improved pro- 
gram will look: 

$ cat search<CR> 

#! /bin/sh 

echo Type in the word and the file name. 

read word file 

if 

grep $word $f ile >/dev/null 
then 

echo $word is in $f ile 
else 

echo $word is NOT in $f ile 

fi 
$ 

Figure 7-30 summarizes your enhanced search program. 
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Ollt?!! JT I Ugi j%d«q# 


search 


- tells you if a word is in a file (user defined) 


command 


arguments 


search 


interactive 


Description: 


Reports whether a word is in a file. 


Remarks: 


The command prompts you for the arguments 
(the word and the file) 



Figure 7-30: Summary of the search Shell Program 



The test Command for Loops 

The test command, which checks to see if certain conditions are true, is a useful 
command for conditional constructs. If the condition is true, the loop will continue. 
If the condition is false, the loop will end and the next command will be executed. 
Some of the useful options for the test command are: 

test -r file<CR> true if the file exists and is readable 

test -w file<CR> true if the file exists and has write permission 

test ~x file<CR> true if the file exists and is executable 

test -s file<CR> true if the file exists and has at least one character 

test varl -eq var2<CR> true if varl equals var2 

test varl -ne var2<CR> true if varl does not equal varl 

You may want to create a shell program to move all the executable files in the current 
directory to your bin directory. You can use the test — x command to select the exe- 
cutable files. Review the example of the for construct that occurs in the mv.flle pro- 
gram, shown in the following example: 

$ cat mv.file<CR> 

#! /bin/sh 

echo type in the directory path 
read path 
for file 
do 

mv $f ile $path/$f ile 
done 
$ 

Create a program called mv.ex that includes an if test — x statement in the do. ..done 
loop to move executable files only. Your program will be as follows: 
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$ cat mv.ex<CR> 

#! /bin/sh 

echo type in the directory path 
read path 
for file 
do 

if test —x $f ile 
then 

mv $f ile $path/$f ile 

fi 
done 

$ 

The directory path will be the path from the current directory to the bin directory. 
However, if you use the value for the shell variable HOME, you will not need to type 
in the path each time. $HOME gives the path to the login directory. $HOME/bin 
gives the path to your bin. 

In the following example, mv.ex does not prompt you to type in the directory name, 
and therefore, does not read the path variable: 

$ cat mv.ex<CR> 
#! /bin/sh 
for file 
do 

if test — x $f ile 
then 

mv $file $HOME/bin/$file 

fi 
done 

$ 

Test the command, using all the files in the current directory, specified with the * 
metacharacter as the command argument. The command lines shown in the following 
example execute the command from the current directory and then changes to bin 
and lists the files in that directory. All executable files should be there. 

$ mv.ex *<CR> 

$ cd; cd bin; ls<CR> 

list_of_executable_files 
$ 

Figure 7-31 summarizes the format and capabilities of the mv.ex shell program. 
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Shell Program Reeap 


mv.ex 


— move all executable files in the current 
directory to the bin directory 


command 


arguments 


mv.ex 


* (all file names) 


Description: 


Moves all files in the current directory with 
execute permission to the bin directory. 


Remarks: 


All executable files in the bin directory (or any 
directory shown by the PATH variable) can be 
executed from any directory. 



Figure 7-31: Summary of the mv.ex Shell Program 



casc.esac 

The case..,esac construction has a multiple choice format that allows you to choose 
one of several patterns and then execute a list of commands for that pattern. The 
pattern statements must begin with the keyword in, and a ) must be placed after the 
last character of each pattern. The command sequence for each pattern is ended with 
;;. The case construction must be ended with esac (the letters of the word case 
reversed). 

The general format for the case construction shown in Figure 7-32: 
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case word<CR> 
in<CR> 

pattern!) <QVL> 

command line 1<CR> 



last command line<CR> 
;;<CR> 
pattern!) <CR> 

command line 1<CR> 



last command line<CR> 
;;<CR> 
pattern3)<QR> 

command line 1<CR> 



last command line<CR> 
;;<CR> 
*)<CR> 

command 1<CR> 



last command<QR> 
;;<CR> 
esac<CR> 



Figure 7-32: The case...esac Conditional Construct 



The case construction tries to match the word following the word case with the pat- 
tern in the first pattern section. If there is a match, the program executes the com- 
mand lines after the first pattern and up to the corresponding ;; . 

If the first pattern is not matched, the program proceeds to the second pattern. Once 
a pattern is matched, the program does not try to match any more of the patterns, but 
goes to the command following esac. 

The * used as a pattern matches any word, and so allows you to give a set of com- 
mands to be executed if no other pattern matches. To do this, it must be placed as 
the last possible pattern in the case construct, so that the other patterns are checked 
first. This provides a useful way to detect erroneous or unexpected input. 
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The patterns that can be specified in the pattern part of each section may use the 
metacharacters *, ?, and [] as described earlier in this chapter for the shell's file 
name expansion capability. This provides useful flexibility. 

The set.term program contains a good example of the case. ..esac construction. This 
program sets the shell variable TERM according to the type of terminal you are using. 
It uses the following command line: 

TERM-terminaLname<CR> 

(For an explanation of the commands used, see the vi tutorial in Chapter 6.) In the 
following example, the terminal is a Teletype 4420, Teletype 5410, or Teletype 5420. 

set.term first checks to see whether the value of term is 4420. If it is, the program 
makes T4 the value of TERM, and terminates. If it the value of term is not 4420, the 
program checks for other values: 5410 and 5420. It executes the commands under 
the first pattern that it finds, and then goes to the first command after the esac com- 
mand. 

The pattern * , meaning everything else, is included at the end of the terminal pat- 
terns. It will warn that you do not have a pattern for the terminal specified and will 
allow you to exit the case construct: 

$ cat set.term<CR> 

#! /bin/sh 

echo If you have a TTY 4420 type in 4420 
echo If you have a TTY 5410 type in 5410 
echo If you have a TTY 5420 type in 5420 
read term 
case $term 
in 

4420) 

TERM=T4 

/ / 

5410) 

TERM=T5 

/ / 

5420) 

TERM-T7 

/ / 
*) 

echo not a correct terminal type 

esac 

export TERM 

echo end of program 

$ 

Notice the use of the export command. You use export to make a variable available 
within your environment and to other shell procedures. What would happen if you 
placed the * pattern first? The set.term program would never assign a value to 
TERM, since it would always match the first pattern *, which means everything. 

Figure 7-33 summarizes the format and capabilities of the set.term shell program. 
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set.term 


- assign a value to TERM (user defined) 


command 


arguments 


set.term 


interactive 


Description: 


Assigns a value to the shell variable TERM 
and then exports that value to other shell pro- 
cedures. 


Remarks: 


This command asks for a specific terminal 
code to be used as a pattern for the case con- 
struction. 



Figure 7-33: Summary of the set.term Shell Program 



Unconditional Control Statements: the break and continue Commands 

The break command unconditionally stops the execution of any loop in which it is 
encountered, and goes to the next command after the done, fi, or esac statement. If 
there are no commands after that statement, the program ends. 

In the example for set.term, you could have used the break command instead of echo 
to leave the program, as the next example shows: 



7-56 USER'S GUIDE 



$ cat set.term<CR> 

#! /bin/sh 

echo If you have a TTY 4420 type in 4420 
echo If you have a TTY 5410 type in 5410 
echo If you have a TTY 5420 type in 5420 
read term 
case $term 
in 

4420) 
TERM=T4 

/ / 

5410) 

TERM=T5 

/ / 

5420) 

TERM=T7 

/ / 
*) 

break 

esac 

export TERM 

echo end of program 

$ 

The continue command causes the program to go immediately to the next iteration of 
a do or for loop without executing the remaining commands in the loop. 

Debugging Programs 

At times you may need to debug a program to find and correct errors. There are two 
options to the sh command (listed below) that can help you debug a program: 

sh ~v shellprogramname prints the shell input lines as they are read by the sys- 
tem 

sh —x shellprogramname prints commands and their arguments as they are exe- 
cuted 

To try out these two options, create a shell program that has an error in it. For 
example, create a file called bug that contains the following list of commands: 

$ cat bug<CR> 

#! /bin/sh 
today- "date" 
echo enter person 
read person 
mail $1 
$person 

When you log off come into my office please. 

$ today . 

MLH 

$ 
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Notice that today equals the output of the date command, which must be enclosed in 
grave accents for command substitution to occur. 

The mail message sent to Tom ($1) at login tommy ($2) should read as the follow- 
ing example shows: 

$ mail<CR> 

From mlh Thu Apr 10 11: 36 CST 1984 
Tom 

When you log off come into my office please. 

Thu Apr 10 11: 36: 32 CST 1986 

MLH 

? 



If you try to execute bug, you will have to press the BREAK or DELETE key to end 
the program. 

To debug this program, try executing bug using sh —v. This will print the lines of the 
file as they are read by the system, as shown below: 

$ sh —v bug tom<CR> 

today="date" 
echo enter person 
enter person 
read person 
tommy 
mail $1 

Notice that the output stops on the mail command, since there is a problem with 
mail. You must use the here document to redirect input into mail. 

Before you fix the bug program, try executing it with sh — x, which prints the com- 
mands and their arguments as they are read by the system: 

$ sh —x bug torn tommy <CR> 

+date 

today^Thu Apr 10 11:07:23 CST 1986 

+ echo enter person 

enter person 

+ read person 

tommy 

+ mail torn 

$ 

Once again, the program stops at the mail command. Notice that the substitutions 
for the variables have been made and are displayed. 

The corrected bug program is as follows: 
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$ cat bug<CR> 

#! /bin/sh 
today="date" 
echo enter person 
read person 
mail $1 <<! 
$person 

When you log off come into my office please. 

$ today 

MLH 

$ 

The tee command is a helpful command for debugging pipelines. While simply pass- 
ing its standard input to its standard output, it also saves a copy of its input into the 
file whose name is given as an argument. 

The general format of the tee command is: 

commandl | tee saverfile \ commandKCR 

saverfile is the file that saves the output of commandl for you to study. 

For example, say you want to check on the output of the grep command in the fol- 
lowing command line: 

who | grep $1 | cut -cl-9<CR> 

You can use tee to copy the output of grep into a file called check, without disturbing 
the rest of the pipeline. 

who | grep $1 | tee check | cut -cl-9<CR> 

The file check contains a copy of the grep output, as shown in the following example: 

$ who | grep mlhmo | tee check | cut -cl-9<CR> 

mlhmo 

$ cat check<CR> 

mlhmo tty61 Apr 10 11:30 
$ 
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The UMIPS system lets you modify your login environment in several ways. One 
modification that users commonly want to make is to change the default values of the 
erase (#) and line kill (@) characters. 

When you log in, the shell first examines a file in your login directory named .profile 
(pronounced "dot profile"). This file contains commands that control your shell 
environment. 

Because the .profile is a file, it can be edited and changed to suit your needs. On 
some systems you can edit this file yourself, while on others, the system administrator 
does this for you. To see whether you have a .profile in your home directory, type: 

Is -al $HOME 

If you can edit the file yourself, you may want to be cautious the first few times. 
Before making any changes to your .profile, make a copy of it in another file called 

safe.profile . Type : 

cp .profile safe.profile<€R> 

You can add commands to your .profile just as you add commands to any other shell 
program. You can also set some terminal options with the stty command, and set 
some shell variables. 



Adding Commands to Your .profile 

Practice adding commands to your .profile. Edit the file and add the following echo 
command to the last line of the file: 

echo Good Morning! I am ready to work for you. 

Write and quit the editor. 

Whenever you make changes to your .profile and you want to initiate them in the 
current work session, you may cause the commands in .profile to be executed directly 
using the . (dot) shell command. The shell will reinitialize your environment by read- 
ing executing the commands in your .profile. Try this now. Type: 

. .profile<CR> 

The system should respond with the following: 

Good Morning ! I am ready to work for you. 



Setting Terminal Options 

The stty command can make your shell environment more convenient. There are 
three options you can use with stty: —tabs, erase ~h, and echoe. 

stty -tabs This option preserves tabs when you are printing. It 

expands the tab setting to eight spaces, which is the 
default. The number of spaces for each tab can be 
changed. (See stty(l) in the User's Reference Manual for 
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details.) 

stty erase "h This option allows you to use the erase key on your key- 
board to erase a letter, instead of the default character #. 
Usually the BACKSPACE key is the erase key. 

stty echoe If you have a terminal with a screen, this option erases 

characters from the screen as you erase them with the 
BACKSPACE key. 

If you want to use these options for the stty command, you can create those com- 
mand lines in your .profile just as you would create them in a shell program. If you 
use the tail command, which displays the last few lines of a file, you can see the 
results of adding those four command lines to your .profile: 

$ tail -4 .profile<CR> 

echo Good Morning ! I am ready to work for you 

stty —tabs 

stty erase ~h 

stty echoe 

$ 

Figure 7-34 summarizes the format and capabilities of the tail command. 





Command Recap 




tail - display the last portion of a file 


command 


options arguments 


tail 


-n filename 


Description: 


Displays the last lines of a file. 


Options: 


Use -n to specify the number of lines n 
(default is ten lines). You can specify a 
number of blocks (— nh) or characters (—nc) 
instead of lines. 



Figure 7-34: Summary of the tail Command 



Creating an rje Directory 

We have often talked about sharing useful programs with other users in this chapter. 
Similarly, these users may have programs or other files that they want to share with 
you. So that these users can send you the files easily, you should create an rje 
(remote job entry) directory: 

mkdir rje 
chmod go+w rje 
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Notice that you have to change the permissions of the directory using chmod. When 
you have an rje directory with the correct permissions, other users can send you files 
using the uucp command. See the uucp(l) manual page in the User's Reference 
Manual for details. 



Using Shell Variables 

Several of the variables reserved by the shell are used in your .profile. You can 
display the current value for any shell variable by entering the following command: 

echo %variahlejname 

Four of the most basic of these variables are discussed next. 

HOME 

This variable gives the path name of your login directory. Use the cd com- 
mand to go to your login directory and type: 

pwd<CR> 

What was the system response? Now type: 
echo $HOME<CR> 

Was the system response the same as the response to pwd? 

$HOME is the default argument for the cd command. If you do not specify a 
directory, cd will move you to $HOME. 

PATH 

This variable gives the search path for finding and executing commands. To 
see the current values for your PATH variable type: 

echo $PATH<CR> 

The system will respond with your current PATH value. 

$ echo $PATH<CR> 

: /mylogin/bin : /bin : /usr/bin : /usr/lib 
$ 

The colon ( : ) is a delimiter between path names in the string assigned to the 
$PATH variable. When nothing is specified before a : , then the current 
directory is understood. Notice how, in the last example, the system looks 
for commands in the current directory first, then in /mylogin/bin/, then in 
/bin, then in /usr/bin, and finally in /usr/lib. 

If you are working on a project with several other people, you may want to set 
up a group bin, a directory of special shell programs used only by your project 
members. The path might be named /projectl/bin. Edit your .profile, and 
add :/projectl/bin to the end of your PATH, as in the next example. 

PATH= ,, :/mylogin/bin:/bin:/usr/lib:/projectl/bin , <CR> 



7-62 USER'S GUIDE 



— Modifying Your Login Environment 

TERM 

This variable tells the shell what kind of terminal you are using. To put assign 
a value to it, you must execute the following three commands in this order: 

TERMzzterminaLname<CR> 
export TERM<CR> 
tput init 

The first two lines, together, are necessary to tell the computer what type of 
terminal you are using. The last line, containing the tput command, tells the 
terminal that the computer is expecting to communicate with the type of ter- 
minal specified in the TERM variable. Therefore this command must always 
be entered after the variable has been exported. 

If you do not want to specify the TERM variable each time you log in, add 
these three command lines to your .profile; they will be executed automati- 
cally whenever you log in. To determine what terminal name to assign to the 
TERM variable, see the instructions in Appendix F, "Setting Up the Termi- 
nal." This appendix also contains details about the tput command. 

If you log in on more than one type of terminal, it would also be useful to 
have your set. term command in your .profile. 

PS1 

This variable sets the primary shell prompt string (the default is the $ sign). 
You can change your prompt by changing the PS1 variable in your .profile. 

Try the following example. Note that to use a multi-word prompt, you must 
enclose the phrase in quotes. Type the following variable assignment in your 
•profile. 

PSl="Your command is my wish<CR>" 

Now execute your .profile (with the . command) and watch for your new 
prompt sign. 

$ . .profile<CR> 

Your ocranand is my wish 

The mundane $ sign is gone forever, or at least until you delete the PS1 vari- 
able from your .profile. 
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2-1. Create a shell program called time from the following command line: 

banner Mate | cut -cl2-19'<CR> 

2-2. Write a shell program that will give only the date in a banner display. Be 
careful not to give your program the same name as a UMIPS system com- 
mand. 

2-3. Write a shell program that will send a note to several people on your system. 

2-4. Redirect the date command without the time into a file. 

2-5, Echo the phrase Dear colleague in the same file that contains the date com- 
mand, without erasing the date. 

2-6. Using the above exercises, write a shell program that will send a memo to the 
same people on your system mentioned in Exercise 2-3. Include in your 
memo: 

The current date and the words Dear colleague at the top of the memo 
The body of the memo (stored in an existing file) 
The closing statement 

2-7. How can you read variables into the mv.file program? 

2-8. Use a for loop to move a list of files in the current directory to another direc- 
tory. How can you move all your files to another directory? 

2-9. How can you change the program search, so that it searches through several 
files? 

Hint: 

for file 
in$* 

2-10. Set the stty options for your environment. 
2-11. Change your prompt to the word Hello. 

2-12. Check the settings of the variables $HOME, $TERM, and $PATH in your 
environment. 
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Command Language Exercises 

1-1. The * at the beginning of a file name refers to all files that end in that file 
name, including that file name. 

$ Is *t<CR> 

cat 
123t 
new. t 
t 
$ 

1-2. The command cat [0-9]* will produce the following output: 

lmemo 

lOOdata 

9 

05 name 

The command echo * will produce a list of all the files in the current direc- 
tory. 

1-3. You can place ? in any position in a file name. 

1-4. The command Is [0-9]* will list only those files that start with a number. 

The command Is [a-m]* will list only those files that start with the letters "a" 
through "m". 

1-5. If you placed the sequential command line in the background mode, the 
immediate system response was the PID number for the job. 

No, the & (ampersand) must be placed at the end of the command line. 
1-6. The command line would be: 

cd; pwd > junk; Is » junk; ed trial<CR> 

1-7. Change the -c option of the command line to read: 

banner Mate | cut -cl-10 K <CR> 
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24. 

$ cat time<CR> 

#! /bin/sh 

banner "date | cut — cl2-19" 
$ 

$ chmod u+x time<CR> 
$ time<CR> 

(banner display of the time 10: 26) 

$ 

2-2. 

$ cat mydate<CR> 

# ! /bin/sh 

banner "date | cut — cl-10" 
$ 

2-3. 

$ cat tofriends<CR> 

#! /bin/sh 

echo Type in the name of the file containing the note, 
read note 

mail janice marylou bryan < $note 
$ 

Or, if you used parameters for the logins, instead of the logins themselves, 
your program may have looked like this: 

$ cat tofriends<CR> 

#! /bin/sh 

echo Type in the name of the file containing the note . 

read note 

mail $* < $note 

$ 

2-4. date | cut -cl-10 > filel<CR> 
2-5. echo Dear colleague » filel<CR> 

2-6. 

$ cat send.memo<CR> 

#! /bin/sh 

date | cut -cl-10 > memol 
echo Dear colleague >> memol 
cat memo >> memol 

echo A memo from M. L. Kelly >> memol 
mail janice marylou bryan < memol 
$ 
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2-7. 

$ cat mv.file<CR> 

#! /bin/sh 

echo type in the directory path 
read path 

echo type in file names, end with <"d> 
while 
read file 
do 

mv $f ile $path/$f ile 
done 
echo all done 
$ 

2-8. 

$ cat mv.file<CR> 

#! /bin/sh 

echo Please type in directory path 
read path 
for file in $* 
do 

mv $f ile $path/$f ile 
done 

$ 

The command line for moving all files in the current directory is: 
$ mv.file *<CR> 

2-9. See hint given with exercise 2-9. 

$ cat search<CR> 

#! /bin/sh 
for file 

in $* 

do 

if grep $word $file >/dev/null 
then echo $word is in $f ile 
else echo $word is NOT in $f ile 
fi 
done 

$ 

2-10. Add the following lines to your .profile. 

stty -tabs<CR> 

stty erase < A hXCR> 

stty echoe<CR> 
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2-11. Add the following command lines to your .profile. 

PSl=HeIio<CR> 
export PS1 

2-12. To check the values of these variables in your home environment: 

□ $ echo $HOME<CR> 

□ $ echo $TERM<CR> 

□ $ echo $PATH<CR> 
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Introduction 



The UMIPS system offers a choice of commands that enable you to communicate 
with users on UMIPS and other UNIX-based systems. Specifically, they allow you to 
send and receive messages, exchange files and form networks. Through networking, a 
user on one system can exchange messages and files between computers, and execute 
commands on remote computers. 

To help you take advantage of these capabilities, this chapter will teach you how to 
use the following commands. 

For exchanging messages: mail, mailx, uname, and uuname 

For exchanging files: uucp, uuto, uupick, and uustat 

For networking: ct, cu, and uux 
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To send messages you can use either the mail or mailx command. These commands 
deliver your message to a file belonging to the recipient. When the recipient logs in 
(or while already logged in), he or she receives a message that says you have mail. 
The recipient can use either the mail or mailx command to read your message and 
reply at his or her leisure. 

The main difference between mail and mailx is that only mailx offers the following 
features: 

■ a choice of text editors (ed or vi) for handling incoming and outgoing messages 

■ a list of waiting messages that allows the user to decide which messages to han- 
dle and in what order 

■ several options for saving files 

■ commands for replying to messages and sending copies (of both incoming and 
outgoing messages) to other users 

You can also use mail or mailx to send short files containing memos, reports, and so 
on. However, if you want to send someone a file that is over a page long, use one of 
the commands designed for transferring files: uuto or uucp. (See "Sending Large 
Files" later in this chapter for descriptions of these commands.) 
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This section presents the mail command. It discusses the basics of sending mail to 
one or more people simultaneously, whether they are working on the local system (the 
same system as you) or on a remote system. It also covers receiving and handling 
incoming mail. 



Sending Messages 

The basic command line format for sending mail is 
mail login<CR> 

where login is the recipient's login name on a UMIPS system. This login name can be 
either of the following: 

■ a login name if the recipient is on your system (for example, bob) 

■ a system name and login name if the recipient is on another UMIPS system 
that can communicate with yours (for example, sys2!bob) 

For the moment, assume that the recipient is on the local system. (We will deal with 
sending mail to users on remote systems later.) Type the mail command at the sys- 
tem prompt, press the RETURN key, and start typing the text of your message on the 
next line. There is no limit to the length of your message. When you have finished 
typing it, send the message by typing a period (.) or a "d (control-d) at the beginning 
of a new line. 

The following example shows how this procedure will appear on your screen. 

$ mail phyllis<CR> 

My meeting with Smith , s<CR> 

group tomorrow has been moved<CR> 

up to 3:00 so I won't be able to<CR> 

see you then. Could we meet<CR> 

in the morning instead?<CR> 

.<CR> 

$ 

The prompt on the last line means that your message has been queued (placed in a 
waiting line of messages) and will be sent. 

Undeliverable Mail 

If you make an error when typing the recipient's login, the mail command will not be 
able to deliver your mail. Instead, it will print two messages telling you that it has 
failed and that it is returning your mail. Then it will return your mail in a message 
that includes the system name and login name of both the sender and intended reci- 
pient, and an error message stating the reason for the failure. 

For example, say you (owner of the login kol) want to send a message to a user with 
the login chris on a system called marmaduk. Your message says The meeting 
has been changed to 2:00. Failing to notice that you have incorrectly typed the 
login as cris, you try to send your message. 
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$ mail cris<CR> 

The meeting has been changed to 2:00. 
XCR> 

mail : Can't send to cris 

mail: Return to kol 

you have mail in /usr/mail/kol 

$ 

The mail that is waiting for you in /usr/mail will be useful if you do not know why the 
mail command has failed, 

$ mail<CR> 

From kol Sat Jan 18 17? 33 EST 1986 

>From kol Sat Jan 18 17 : 33 EST 1986 forwarded by kol 

* * * *UNDELI VERABLE MAIL sent to cris, being returned by marmaduk ! kol 

mail : ERROR # 8 ' Invalid recipient' encountered on system marmaduk 

The meeting has been changed to 2:00. 

? 

To learn how to display and handle this message see "Managing Incoming Mail" later 
in this chapter. 

Sending Mail to One Person 

The following example shows a typical message. 

$ mail tommy <CR> 
Tom f <CR> 

There's a meeting of the review committee<CR> 

at 3:00 this afternoon. D.F. wants your<CR> 

comments and an idea of how long you think<CR> 

the project will take to complete . < CR> 

B.K.<CR> 

•<CR> 

$ 

When Tom logs in at his terminal (or while he is already logged in), he receives a 
message that tells him he has mail waiting: 

$ you have mail 

To find out how he can read his mail, see the section "Managing Incoming Mail" in 
this chapter. 

You can practice using the mail command by sending mail to yourself. Type in the 
mail command and your login ID, and then write a short message to yourself. When 
you type the final period or "d, the mail will be sent to a file named after your login 
ID in the /usr/mail directory, and you will receive a notice that you have mail. 

Sending mail to yourself can also serve as a handy reminder system. For example, 
suppose you (login ID bob) want to call someone the next morning. Send yourself a 
reminder in a mail message. 
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$ mail bob<CR> 

Call Accounting and find out<CR> 

why they haven't returned my 1985 figures!<CR> 

.<CR> 

$ 

When you log in the next day, a notice will appear on your screen informing you that 
you have mail waiting to be read. 

Sending Mail to Several People Simultaneously 

You can send a message to a number of people by including their login names on the 
mail command line. For example: 

$ mail tommy jane wombat dave<CR> 
Diamond cutters,<CR> 

The game is on for tonight at diamond three.<CR> 
Don't forget your gloves!<CR> 
Your Manager<CR> 
•<CR> 

$ 

Figure 8-1 summarizes the syntax and capabilities of the mail command. 





Command Recap 


mail - 


sends a message to another user's login 


command 


options arguments 


mail 


none [systemjname!]lo$in 


Description: 


Typing mail followed by one or more login 
names, sends the message typed on the lines 
following the command line to the specified 
login(s). 


Remarks: 


Typing a period or a "d (followed by the 
RETURN key) at the beginning of a new line 
sends the message. 



Figure 8-1: Summary of Sending Messages with the mail Command 
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Sending Mail to Remote Systems: the uname and 
uuname Commands 

Until now we have assumed that you are sending messages to users on the local 
UMIPS system. However, your company may have three separate computer systems, 
each in a different part of a building, or you may have offices in several locations, 
each with its own system. 

You can send mail to users on other systems simply by adding the name of the 
recipient's system before the login ID on the command line. 

mail sys2!bob<CR> 

Notice that the system name and the recipient's login ID are separated by an exclama- 
tion point. 

Before you can run this command, however, you need three pieces of information: 

■ the name of the remote system 

■ whether or not your system and the remote system communicate 

■ the recipient's login name 

The uname and uuname commands allow you to find this information. 

If you can, get the name of the remote system and the recipient's login name from the 
recipient. If the recipient does not know the system name, have him or her issue the 
following command on the remote system: 

uname — n<CR> 

The command will respond with the name of the system. For example: 

$ uname — n<CR> 

dumbo 
$ 

Once you know the remote system name, the uuname command can help you verify 
that your system can communicate with the remote system. At the prompt, type: 

uuname<CR> 

This generates a list of remote systems with which your system can communicate. If 
the recipient's system is on that list, you can send messages to it by mail. 

You can simplify this step by using the grep command to search through the uuname 
output. At the prompt, type: 

uuname | grep $ystem<CR> 

(Here system is the recipient's system name.) If grep finds the specified system name, 
it prints it on the screen. For example: 

$ uuname | grep dumbo<CR> 

dumbo 

$ 

This means that dumbo can communicate with your system. If dumbo does not com- 
municate with your system, uuname returns a prompt. 
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$ uuname | grep dumbo<CR> 

$ 

To summarize our discussion of uname and uuname, consider an example. Suppose 
you want to send a message to login sarah on the remote system dumbo. Verify that 
dumbo can communicate with your system and send your message. The following 
example shows both steps. 

$ uuname | grep dumbo<CR> 

dumbo 

$ mail dumbo!sarah<CR> 
Sarah,<CR> 

The final counts for the writing seminar<CR> 

are as follows:<CR> 

<CR> 

Our department - 18<CR> 

Your department - 20<CR> 

<CR> 

Tom<CR> 

.<CR> 

$ 

Figures 8-2 and 8-3 summarize the syntax and capabilities of the uname and uuname 
commands, respectively. 





Command Recap 




uname - displays the system name 


command 


options arguments 


uname 


— n and others* none 


Description: 


uname —n displays the name of the system on 
which your login resides. 



See the uname (1) manual page in the User's Reference Manual for 
all available options and an explanation of their capabilities. 

Figure 8-2: Summary of the uname Command 
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Command Recap 


uuname - displays a list of networked systems 


command 


options arguments 


uuname 


none none 


Descriptions 


uuname displays a list of remote systems that 
can communicate with your system. 



Figure 8-3: Summary of the uuname Command 



Managing Incoming Mail 

As stated earlier, the mail command also allows you to display messages sent to you 
by other users on your screen so you can read them. If you are logged in when some- 
one sends you mail, the following message is printed on your screen: 

you have mail 

This means that one or more messages are being held for you in a file called 
/usr/mml/yourjogin , usually referred to as your mailbox. To display these messages 
on your screen, type the mail command without any arguments: 

mail<CR> 

The messages will be displayed one at a time, beginning with the one most recently 
received. A typical mail message display looks like this: 

$ mail 

From tommy Wed May 21 15: 33 CST 1986 
Bob, 

Looks like the meeting has been cancelled. 

Do you still want the material for the technical review? 

Tom 

*? 

The first* line, called the header, provides information about the message: the login 
name of the sender and the date and time the message was sent. The lines after the 
header (up to the line containing the ?) comprise the text of the message. 

If a long message is being displayed on your terminal screen, you may not be able to 
read it all at once. You can interrupt the printing by typing < A s> (control-s). This 
will freeze the screen, giving you a chance to read. When you are ready to continue, 
type <"q> and the printing will resume. 

After displaying each message, the mail command prints a ? prompt and waits for a 
response. You have many options, for example, you can leave the current message in 
your mailbox while you read the next message; you can delete the current message; or 
you can save the current message for future reference. For a list of mail's available 
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options, type a ? in response to mail's ? prompt. 

To display the next message without deleting the current message, press the 
RETURN key after the question mark. 

?<CR> 

The current message remains in your mailbox and the next message is displayed. If 
you have read all the messages in your mailbox, a prompt appears. 

To delete a message, type a d after the question mark: 

? d<CR> 

The message is deleted from your mailbox. If there is another message waiting, it is 
then displayed. If not, a prompt appears as a signal that you have finished reading 
your messages. 

To save a message for later reference, type an s after the question mark: 
? s<CR> 

This saves the message, by default, in a file called mbox in your home directory. To 
save the message in another file, type the name of that file after the s command. 

For example, to save a message in a file called mailsave (in your current directory), 
enter the response shown after the question mark: 

? s mailsave<CR> 

If mailsave is an existing file, the mail command appends the message to it. If there 
is no file by that name, the mail command creates one and stores your message in it. 
You can later verify the existence of the new file by using the Is command. (Is lists 
the contents of your current directory.) 

You can also save the message in a file in a different directory by specifying a path 
name. For example: 

? s projectl/memo<CR> 

This is a relative path name that identifies a file called memo (where your message 
will be saved) in a subdirectory (projectl) of your current directory. You can use 
either relative or full path names when saving mail messages. (For instructions on 
using path names, see Chapter 3.) 

To quit reading messages, enter the response shown after the question mark: 
? q<CR> 

Any messages that you have not read are kept in your mailbox until the next time you 
use the mail command. 

To stop the printing of a message entirely, press the BREAK key. The mail com- 
mand will stop the display, print a ? prompt, and wait for a response from you. 

Figure 8-4 summarizes the syntax and capabilities of the mail command for reading 
messages. 
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Command Recap 




mail - reads messages sent to your login 


command 


options arguments 


mail 


available* none 


Description: 


When issued without options, the mail com- 
mand displays any messages waiting in your 
mailbox (the system file /mr/mail/y our Jogiri). 


Remarks: 


A question mark (?) at the end of a message 
means that a response is expected. A full list 
of possible responses is given in the User's 
Reference Manual. 



* See the mail(l) manual page in the User's Reference Manual for all 
available options and an explanation of their capabilities. 

Figure 8-4: Summary of Reading Messages with the mail Command 
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This section introduces the mailx facility. It explains how to set up your mailx 
environment, send messages with the mailx command, and handle messages that have 
been sent to you. The material is presented in four parts: 

■ mailx Overview 

■ Sending Messages 

■ Managing Incoming Mail 

■ The .mailrc File 
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The mailx command is an enhanced version of the mail command. There are many 
options to mailx that are not available in mail for sending and reading mail. For 
example, you can define an alias for a single login or for a group. This allows you to 
send mail to an individual using a name or word other than their login ID, and to 
send mail to a whole group of people using a single name or word. When you use 
mailx to read incoming mail you can save it in various files, edit it, forward it to 
someone else, respond to the person who originated the message, and so forth. By 
using mailx environment variables you can develop an environment to suit your indivi- 
dual tastes. 

If you type the mailx command with one or more logins as arguments, mailx decides 
you are sending mail to the named users, prompts you for a summary of the subject, 
and then waits for you to type in your message or issue a command, The section 
"How to Send Messages" describes features that are available to you for editing, 
incorporating other files, adding names to copy lists, and more. 

If you enter the mailx command with no arguments, mails checks incoming mail for 
you in a file named fmr/mmlfyourjogin. If there is mail for you in that file, you are 
shown a list of the items and given the opportunity to read, store, remove or transfer 
each one to another file. The section entitled "How to Manage Incoming Mail" pro- 
vides some examples and describes the options available. 

If you choose to customize mailx, you should create a start-up file in your home direc 
tory called .mailrc. The section on "The ,mailre File" describes variables you can 
include in your start-up file. 

mailx has two modes of functioning; input mode and command mode. You must be 
in input mode to create and send messages. Command mode is used to read incom- 
ing mail. You can use any of the following methods to control the way mailx works 
for you: 

■ by entering options on the command line. (See the mailx(l) manual page in 
the User's Reference Manual.) 

■ by issuing commands when you are in input mode, for example, creating a mes 
sage to send. These commands are always preceded by a ~ (tilde) and are 
referred to as tilde escapes. (See the mailx(l) manual page in the User's Refer- 
ence Manual.) 

» by issuing commands when you are in command mode, for example, reading 
incoming mail. 

■ by storing commands and environment variables in a start-up file in your home 
directory called $HOME/*mailre, 

Tilde escapes are discussed in "Sending Messages," command mode commands in 
"Managing Incoming Mail," and the .mailrc file in "The .mailrc File." 
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In this section, we will look at command line options. 
The syntax for the mailx command is: 
mailx [options] [name...] 

The options are flags that control the action of the command, and name... represents 
the intended recipients. 

Anything on the command line other than an option preceded by a hyphen is read by 
mailx as a name; that is, the login or alias of a person to whom you are sending a 
message. 

Two of the command line options deserve special mention: 

■ — f [filename]: Allows you to read messages from filename instead of your mail- 
box. 

Because mailx lets you store messages in any file you name, you need the — f 
option to review these stored options. The default storage file is 
$HOME/mbox, so the command: 

mailx -f 

is used to review messages stored there. 

■ — n: Do not initialize from the system default mailx.rc file. 

If you have your own .mailrc file (see "The .mailrc File") mailx will not look 
through the system default file for specifications when you use the — n option, 
but will go directly to your .mailrc file. This results in faster initialization; sub- 
stantially faster when the system is busy. 
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To send a message to another UMIPS system user, enter the following command: 

$ mailx daves<CR> 

The login name specified belongs to the person who is to receive the message. The 
system puts you into input mode and prompts you for the subject of the message. 
(You may have to wait a few seconds for the Subject : prompt if the system is very 
busy.) This is the simplest way to run the mailx command; it differs very little from 
the way you run the mail command. 

The following examples show how you can edit messages you are sending, incorporate 
existing text into your messages, change the header information, and perform other 
tasks that take advantage of the mailx command's capabilities. Each example is fol- 
lowed by an explanation of the key points illustrated in the example. 

$ mailx daves<CR> 
Subject: 

Whether to include a subject or not is optional. If you elect not to, press the 
RETURN key. The cursor moves to the next line and the program waits for you to 
enter the text of the message. 

$ mailx daves<CR> 
Subj ect : meeting<CR> 

We're having a meeting for novice mailx users in<CR> 

the auditorium at 9:00 tomorrow.<CR> 

Would you be willing to give a demonstration?<CR> 

Bob<CR> 

~. <CR> 

CC : <CR> 

$ 

There are two important things to notice about the above example: 

■ You break up the lines of your message by pressing the RETURN key at the 
end of each line. This makes it easier for the recipient to read the message, 
and prevents you from overflowing the line buffer. 

■ You end the text and send the message by entering a tilde and a period together 
(~.) at the beginning of a line. The system responds with an end-of-text notice 
(eot) and a prompt. 

There are several commands available to you when you are in input mode (as we were 
in the example). Each of them consists of a tilde (~), followed by an alphabetic char- 
acter, entered at the beginning of a line. Together they are known as tilde escapes. 
(See the mailx(l) manual page in the User's Reference Manual.) Most of them are 
used in the examples in this section. 

You can include the subject of your message on the command line by using the — s 
option. For example, the command line: 

$ mailx — s "meeting" daves<CR> 

is equivalent to: 

$ mailx daves<CR> 
Subject: meeting<CR> 
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The subject line will look the same to the recipient of the message. Notice that when 
putting the subject on the command line, you must enclose a subject that has more 
than one word in quotation marks. 



Editing the Message 

When you are in the input mode of mailx, you can invoke an editor by entering the ~e 
(tilde e) escape at the beginning of a line. The following example shows how to use 
tilde: 

$ mailx daves<CR> 

Sub j ect : Testing my tilde<CR> 

When entering the text of a message<CR> 

that has somehow gotten grabled<CR> 

you may invoke your favorite editor<CR> 

by means of a ~e (tilde e). 



Notice that you have misspelled a word in your message. To correct the error, use ~e 
to invoke the editor, in this case the default editor, ed. 



~e<CR> 

12 

/grabled/p 

that has somehow gotten grabled 
s/gra/gar/p 

that has somehow gotten garbled 
w 

132 

q 

(continue) 

What more can I tell you? 



In this example the ed editor was used. Your .profile or a .mailrc file controls which 
editor will be invoked when you issue a ~e escape command. The ~v (tilde v) escape 
invokes an alternate editor (most commonly, vi). 

When you exited from ed (by typing q), the mailx command returned you to input 
mode and prompted you to continue your message. At this point you may want to 
preview your corrected message by entering a ~p (tilde p) escape. The ~p escape 
prints out the entire message up to the point where the ~p was entered. Thus, at any 
time during text entry, you can review the current contents of your message. 
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P 

Message contains : 
To : daves 

Subject : Testing my tilde 

When entering the text of a message 
that has somehow gotten garbled 
you may invoke your favorite editor 
by means of a tilde e (~e) . 
What more can I tell you? 
(continue) 

EOT 
$ 



Incorporating Existing Text into Your Message 

mailx provides four ways to incorporate material from another source into the mes- 
sage you are creating. You can: 

■ read a file into your message 

■ read a message you have received into a reply 

■ incorporate the value of a named environment variable into a message 

■ execute a shell command and incorporate the output of the command into a 

message 

The following examples show the first two of these functions. These are the most 
commonly used of these four functions. For information about the other two, see the 
mailx(l) manual page of the User's Reference Manual. 

Reading a File into a Message 

$ mailx daves<CR> 

Subject: Work Schedule <CR> 

As you can see from the f ollowing< CR> 

~r letters/Mel 

"letters/filel" 10/725 
we have our work cut out for us. 
Please give me your thoughts on this. 
-Bob 

EOT 
$ 

As the example shows, the ~r (tilde r) escape is followed by the name of the file you 
want to include. The system displays the file name and the number of lines and char- 
acters it contains. You are still in input mode and can continue with the rest of the 
message. When the recipient gets the message, the text of letters/filel is included. 
(You can, of course, use the ~p (tilde p) escape to preview the contents before 
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sending your message.) 

Incorporating a Message from Your Mailbox into a Reply 

$ mailx<CR> 

mailx version 2.14 2/9/85 Type ? for help, 
"usr/mail/roberts": 2 messages 1 new 

>N 1 abc Tue May 1 08:09 8/155 Meeting Notice 

2 hqtrs Mon Apr 30 16:57 4/127 Schedule 

? m jones<CR> 
Sub j ect : Hq Schedule<CR> 

Here is a copy of the schedule from headquarters. ..<CR> 
~f2<CR> 

Interpolating: 2 
(continue) 

As you can see, the boss will be visiting our district on<CR> 
the 14th and 15th.<CR> 
— Robert 

EOT 

There are several important points illustrated in this example: 

■ The sequence begins in command mode, where you read and respond to your 
incoming mail. Then you switch into input mode by issuing the command m 
jones (meaning send a message to jones). 

■ The ~f escape is used in input mode to call in one of the messages in your mail- 
box and make it part of the outgoing message. The number 2 after the ~f means 
message 2 is to be interpolated (read in). 

■ mailx tells you that message 2 is being interpolated and then tells you to con- 
tinue. 

■ When you finish creating and sending the message, you are back in command 
mode, as shown by the ? prompt. You may now do something else in com- 
mand mode, or exit mailx by typing q. 

An alternate command, the ~m (tilde m) escape, works the way that ~f does except 
the read-in message is indented one tab stop. Both the ~m and ~f commands work 
only if you start out in command mode and then enter a command that puts you into 
input mode. Other commands that work this way will be covered in the section "How 
to Manage Incoming Mail." 



Changing Parts of the Message Header 

The header of a mailx message has four components: 

■ subject 

■ recipient(s) 

■ copy-to list 

■ blind-copy list (a list of intended recipients that is not shown on the copies sent 
to other recipients) 
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When you enter the mailx command followed by a login or an alias you are put into 
input mode and prompted for the subject of your message. Once you end the subject 
line by pressing the RETURN key, mailx expects you to type the text of the message. 
If, at any point in input mode, you want to change or supplement some of the header 
information, there are four tilde escapes that you can use: ~h, ~t, ~c, and ~b. 

~h displays all the header fields: subject, recipient, copy-to list, and blind 
copy list, with their current values. You can change a current value, add 
to it, or, by pressing the RETURN key, accept it. 

~t lets you add names to the list of recipients. Names can be either login 
names or aliases. 

~c lets you create or add to a copy-to list for the message. Enter either login 
names or aliases of those to whom a copy of the message should be sent. 

~b lets you create or add to a blind-copy list for the message. 

All tilde escapes must be in the first position on a line. For the ~t, ~c or ~b, any addi- 
tional material on the line is taken to be input for the list in question. Any additional 
material on a line that begins with a ~h is ignored. 



Adding Your Signature 

If you want, you can establish two different signatures with the sign and Sign environ- 
ment variables. These can be invoked with the ~a (tilde a) or ~A (tilde A) escape, 
respectively. Assume you have set the value Supreme Commander to be called by the 
~A escape. Here's how it would work: 

$ mailx — s orders all<CR> 

Be ready to move out at 0400 hours.<CR> 

~A<CR> 

Supreme Commander 

\<CR> 

EOT 

$ 

Having both escapes ("a and ~A) allows you to set up two forms for your signature. 
However, because the sender's login automatically appears in the message header 
when the message is read, no signature is required to identify you. 



Keeping a Record of Messages You Send 

The mailx command offers several ways to keep copies of outgoing messages. Two 
that you can use without setting any special environment variables are the ~w (tilde w) 
escape and the — F option on the command line. 

The ~w followed by a file name causes the message to be written to the named file. 
For example: 
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$ mailx bdr<CR> 

Sub j ect : Saying Copies<CR> 

When you want to save a copy of<CR> 

the text of a message, use the tilde w.<CR> 

~w savemail 

"savemail" 2/71 

EOT 
$ 

If you now display the contents of sayemail, you will see this: 

$ cat savemail<CR> 

When you want to save a copy of 

the text of a message, use the tilde w. 

$ 

The drawback to this method, as you can see, is that none of the header information 
is saved. 

Using the —F option on the command line does preserve the header information. It 
works as follows: 

$ mailx — F -s Sayings bdr<CR> 
This method appends this message to a 
file in my current directory named bdr. 

EOT 
$ 

We can check the results by looking at the file bdr. 
$ cat bdr<CR> 

From: kol Fri May 2 11:14:45 1986 
To : bdr 

Sub j ect : Savings 

This method appends this message to a 
file in my current directory named bdr. 
$ 

The — F option appends the text of the message to a file named after the first reci- 
pient. If you have used an alias for the recipient(s) the alias is first converted into the 
appropriate login(s) and the first login is used as the file name. As noted above, if 
you have a file by that name in your current directory, the text of the message is 
appended to it. 

Exiting from mailx 

When you have finished composing your message, you can leave mailx by typing any 
of the following three commands: 

tilde period (~.) is the standard way of leaving input mode. It also sends 
the message. If you entered input mode from the command mode of 
mailx, you now return to the command mode (as shown by the ? prompt 
you receive after typing this command). If you started out in input mode, 
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you now return to the shell (as shown by the shell prompt). 

~q tilde q (~q) simulates an interrupt. It lets you exit the input mode of 
mailx. If you have entered text for a message, it will be saved in a file 
called dead.letter in your home directory. 

~x tilde x (~x) simulates an interrupt. It lets you exit the input mode of mailx 
without saving anything. 



Summary 

In the preceding paragraphs we have described and shown examples of some of the 
tilde escape commands available when sending messages via the mailx command. 
(See the mailx(l) manual page in the User's Reference Manual.) 
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mailx has over fifty commands which help you manage your incoming mail. See the 
mailx(l) manual page in the User's Reference Manual for a list of all of them (and 
their synonyms) in alphabetic order. The most commonly used commands (and argu- 
ments) are described in the following subsections: 

■ the msglist argument 

■ commands for reading and deleting mail 

■ commands for saving mail 

■ commands for replying to mail 

■ commands for getting out of mailx 



The msglist Argument 

Many commands in mailx take a form of the msglist argument. This argument pro- 
vides the command with a list of messages on which to operate. If a command 
expects a msglist argument and you do not provide one, the command is performed 
on the current message. Any of the following formats can be used for a msglist: 

n message number n the current message 

the first undeleted message 

$ the last message 

* all messages 

n-m an inclusive range of message numbers 

user all messages from user 

/string All messages with string in the subject line (case is ignored) 

:c all messages of type c where c is: 

d - deleted messages 
n - new messages 
o - old messages 
r - read messages 
u - unread messages 

The context of the command determines whether this type of specification makes 
sense. 

Here are two examples (the ? is the command mode prompt): 

? d 1-3 [ Delete messages 1, 2 and 3 ] 

? s bdr bdr [ Save all messages from user bdr in a 

file named bdr , ] 

Additional examples may be found throughout the next three subsections. 
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Commands for Reading and Deleting Mail 

When a message arrives in your mailbox the following notice appears on your screen: 
you have mail 

The notice appears when you log in or when you return to the shell from another pro- 
cedure. 

Reading Mail 

To read your mail, enter the mailx command with or without arguments. Execution 
of the command places you in the command mode of mailx. The next thing that 
appears on your screen is a display that looks something like this: 

mailx version 2 . 14 10/19/86 Type ? for help 
"/usr/mail/bdr" : 3 messages 3 new 

> N 1 rbt Thur Apr 30 14 : 20 8/190 Review Session 
N 2 admin Thur Apr 30 15 : 56 5/84 New printer 
N 3 daves Fri May 1 08 : 39 64/1574 Reorganization 

? 

The first line identifies the version of mailx used on your system, displays the date, 
and reminds you that help is available by typing a question mark (?). The second line 
shows the path name of the file used as input to the display (the file name is normally 
the same as your login name) together with a count of the total number of messages 
and their status. The rest of the display is header information from the incoming 
messages. The messages are numbered in sequence with the last one received at the 
bottom of the list. To the left of the numbers there may be a status indicator; N for 
new, U for unread. A greater than sign (>) points to the current message. Other 
fields in the header line show the login of the originator of the message, the day, date 
and time it was delivered, the number of lines and characters in the message, and the 
message subject. The last field may be blank. 

When the header information is displayed on your screen, you can print messages 
either by pressing the RETURN key or entering a command followed by a msglist 
argument. If you enter a command with no msglist argument, the command acts on 
the message pointed at by the > sign. Pressing the RETURN key is the equivalent of 
a typing the p (for print) command without a msglist argument; the message displayed 
is the one pointed at by the > sign. To read some other message (or several others in 
succession), enter a p (for print) or t (for type) followed by the message number(s). 
Here are some examples: 

? <CR> [ Print the current message. ] 

? p 2<CR> [ Print message number 2. ] 

? p daves<CR> [ Print all messages from user daves. ] 

The command t (for type) is a synonym of p (for print). 

Scanning Your Mailbox 

The mailx command lets you look through the messages in your mailbox while you 
decide which ones need your immediate attention. 

When you first enter the mailx command mode, the banner tells you how many mes- 
sages you have and displays the header line for twenty messages. (If you are dialed 
into the computer system, only the header lines for ten messages are displayed.) If 
the total number of messages exceeds one screenful, you can display the next screen 
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by entering the z command. Typing z- causes a previous screen (if there is one) to 
be displayed. If you want to see the header information for a specific group of mes- 
sages, enter the f (for from) command followed by the msglist argument. 

Here are examples of those commands: 



Switching to Other Mail Files 

When you enter mailx by issuing the command: 

$ mailx<CR> 
you are looking at the file /usr/mm\/your_login . 

mailx lets you switch to other mail files and use any of the mailx commands on their 
contents. (You can even switch to a non-mail file, but if you try to use mailx com- 
mands you are told No applicable messages.) The switch to another file is done 
with the fi or fold command (they are synonyms) followed by the filename. The fol- 
lowing special characters work in place of the filename argument: 

% the current mailbox 

%login the mailbox of the owner of login (if you have the required permissions) 
# the previous file 
& the current mbox 
Here is an example of how this might look on your screen: 
$ mailx<CR> 

mailx version 2.14 10/19/86 Type ? for help, 
"usr/mail/daves" : 3 messages 2 new 3 unread 

U 1 jaf Sat May 9 07: 55 7/137 test25 
> N 2 todd Sat May 9 08:59 9/377 UNITS requirements 

N 3 has Sat May 9 11:08 29/1214 access to bailey 

? fi & [ Enter this command to transfer to your mbox. ] 

Held 3 messages in /usr/mail/daves 

"/f sl/daves/fobox" : 74 messages 10 unread 



Deleting Mail 

To delete a message, enter a d followed by a msglist argument. If the msglist argu- 
ment is omitted, the current message is deleted. The messages are not deleted until 
you leave the mailbox file you are processing. Prior to that, the u (for undelete) gives 
you the opportunity to change your mind. Once you have issued the quit command 
(q) or switched to another file, however, the deleted messages are gone. 



? z 

? z- 

? f daves 



[ Scroll forward one screenful of header lines. ] 

[ Scroll backward one screenful. ] 

[ Display headers of all messages from user daves. ] 



? q<CR> 

$ 
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mailx permits you to combine the delete and print command and enter a dp. This is 
like saying, "Delete the message I just read and show me the next one." Here are 
some examples of the delete command: 



Commands for Saving Mai! 

All messages not specifically deleted are saved when you quit mailx. Messages that 
have been read are saved in a file in your home directory called mbox. Messages that 
have not been read are held in your mailbox {/mtimmliyourjogiri). 

The command to save messages comes in two forms: with an upper case or a lower 
case s. The syntax for the upper case version is: 



Messages specified by the msglist argument are saved in a file in the current directory 
named for the author of the first message in the list. 

The syntax for the lower case version is: 
s [msglist] {filename} 

Messages specified by the msglist argument are saved in the file named in the filename 
argument. If you omit the msglist argument, the current message is saved. If you are 
using logins for file names, this can lead to some ambiguity. If mailx is puzzled, you 
will get an error message. 



The command for replying to mail comes in two forms: with an upper case or a 
lower case r. The principal difference between the two forms is that the upper case 
form (R) causes your response to be sent only to the originator of the message, while 
the lower case form (r) causes your response to be sent not only to the originator but 
also to all other recipients. (There are other differences between these two forms. 
For details, see the mailx(l) manual page in the User's Reference Manual.) 

When you reply to a message, the original subject line is picked up and used as the 
subject of your reply. Here's an example of the way it looks: 



d * 
d r 
dp 

d2»5 



Delete all my messages. ] 

Delete all messages that have been read. ] 

Delete the current message and print the next one. ] 

Delete messages 2 through 5. ] 



S [msglist] 



Commands for Replying to Mail 
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$ mailx<CR> 



mailx version 2.14 10/19/83 Type ? for help, 
"usr/mail/daves" : 3 messages 2 new 3 unread 

U 1 jaf Wed May 9 07:55 7/137 test25 

> N 2 todd Wed May 9 08:59 9/377 UNITS requirements 

N 3 has Wed May 9 11:08 29/1214 access to bailey 



? R2 
To : todd 

Subject: Re: UNITS requirements 



Assuming the message about UNITS requirements had been sent to some additional 
people, and the lower case r had been used, the header might have appeared like this: 

? r2 

To: todd eg has jcb bdr 
Subject: Re: UNITS requirements 



Commands for Getting Out of mailx 

There are two standard ways of leaving mailx: with a q or with an x. If you leave 
mailx with a q, you see messages that summarize what you did with your mail. They 
look like this: 

? q<CR> 

Saved 1 message in /f s 1/bdr/mbox 
Held 1 message in /usr/mail/bdr 
$ 

From the example we can surmise that user bdr had at least two messages, read one 
and either left the other unread or issued a command asking that it be held in 
/usr/mail/bdr. If there were more than two messages, the others were deleted or 
saved in other files, mailx does not issue a message about those. 

If you leave mailx with an x, it is almost as if you had never entered. Mail read and 
messages deleted are retained in your mailbox. However, if you have saved messages 
in other files, that action has already taken place and is not undone by the x. 



mailx Command Summary 

In the preceding subsections we have described some of the most frequently used 
mailx commands. (See the mailx(l) manual page in the User's Reference Manual for a 
complete list.) If you need help while you are in the command mode of mailx, type 
either a ? or help after the ? prompt. A list of mailx commands and what they do 
will be displayed on your terminal screen. 



COMMUNICATION TUTORIAL 8-25 



The •maiirc File 



The .mailrc file contains commands to be executed when you invoke mailx. 

There may be a system-wide start-up file (/usr/lib/mailx/mailx.rc) on your system. If 
it exists it is used by the system administrator to set common variables. Variables set 
in your .mailrc file take precedence over those in mailx.rc. 

Most mailx commands are legal in the .mailrc file. However, the following com- 
mands are NOT legal entries: 

! (or) shell escape to the shell 

Copy save messages in msglist in a file whose name is derived from 

the author 

edit invoke the editor 

visual invoke vi 

followup respond to a message 

Followup respond to a message, sending a copy to msglist 

mail switch into input mode 

reply respond to a message 

Reply respond to the author of each message in msglist 

You can create your own .mailrc with any editor, or copy a friend's. Figure 8-5 
shows a sample .mailrc file. 

if r 

cd $HOME/mail 

endif 

set allnet append asksub askcc autoprint dot 

set metoo quiet save showto header hold keep keepsave 

set outfolder 

set folder='mail' 

set r ecord= ' outbox ' 

set crt=24 

set EDITOR= ' /bin/ed ' 
set sign=' Roberts' 

set Sign=' Jackson Roberts , Supervisor' 

set toplines=10 

alias fred f js 

alias bob rem 

alias alice ap 

alias mark met 

alias donna dr 

alias pat pat 

group robertsgrp fred bob alice pat mark 

group accounts robertsgrp donna 

Figure 8-5: Sample .mailrc File 
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The example in Figure 8-5 includes the commands you are most likely to find useful: 
the set command and the alias or group commands. 

The set command is used to establish values for environment variables. The com- 
mand syntax is: 

set 

set name 

set name = string 

set name s= number 

When you issue the set command without any arguments, set produces a list of all 
defined variables and their values. The argument name refers to an environmental 
variable. More than one name can be entered after the set command. Some vari- 
ables take a string or numeric value. String values are enclosed in single quotes. 

When you put a value in an environment variable by making an assignment such as 
HOME=my_./ogw , you are telling the shell how to interpret that variable. However, 
this type of assigment in the shell does not make the value of the variable accessible 
to other UMIPS system programs that need to reference environment variables. To 
make it accessible, you must export the variable. If you set the TERM variable in 
your environment in Chapter 6 or Chapter 7, you will remember using the export 
command as shown in the following example: 

$ TERM=5425 
$ export TERM 

When you export variables from the shell in this way, programs that reference 
environment variables are said to import them. Some of these variables (such as 
EDITOR and VISUAL) are not peculiar to mailx, but may be specified as general 
environment variables and imported from your execution environment. If a value is 
set in .mailrc for an imported variable it overrides the imported value. There is an 
unset command, but it works only against variables set in .mailrc; it has no effect on 
imported variables. 

There are forty-one environment variables that can be defined in your .mailrc; too 
many to be fully described in this document. For complete information, consult the 
mailx(l) manual page in the User's Reference Manual. 

Three variables used in the example in Figure 8-5 deserve special attention because 
they demonstrate how to organize the filing of messages. These variables are: folder, 
record, and outfolder. All three are interrelated and control the directories and files 
in which copies of messages are kept. 

To put a value into the folder variable, use the following format: 
set fo\der=directory 

This specifies the directory in which you want to save standard mail files. If the direc- 
tory name specified does not begin with a / (slash), it is presumed to be relative to 
$HOME. If folder is an exported shell variable, you can specify file names (in com- 
mands that call for a filename argument) with a / before the name; the name will be 
expanded so that the file is put into the folder directory. 

To put a value in the record variable, use the following format: 

set record— filename 

This directs mailx to save a copy of all outgoing messages in the specified file. The 
header information is saved along with the text of the message. By default, this 
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variable is disabled. 

The outfolder variable causes the file in which you store copies of outgoing messages 
(enabled by the variable records) to be located in the folder directory. It is esta- 
blished by being named in a set command. The default is nooutf older. 

The alias and group commands are synonyms. In Figure 8-5, the alias command is 
used to associate a name with a single login; the group command is used to specify 
multiple names that can be called in with one pseudonym. This is a nice way to dis- 
tinguish between single and group aliases, but if you want, you can treat the com- 
mands as exact equivalents. Notice, too, that aliases can be nested. 

In the .mailrc file shown in Figure 8-5, the alias robertsgroup represents five users; 
three of them are specified by previously defined aliases and one is specified by a 
login. The fifth user, pat, is specified by both a login and an alias. The next group 
command in the example, accounts, uses the alias robertsgroup plus the alias donna. 
It expands to twelve logins. 

The .mailrc file in Figure 8-5 includes an if-endif command. The full syntax of that 
command is: 

if s|r maiLcommands 
else maiLcommands 
endif 

The s and r stand for send and receive, so you can cause some initializing commands 
to be executed according to whether mailx is entered in input mode (send) or com- 
mand mode (receive). In the preceding example, the command is issued to change 
directory to $HOME/mail if reading mail. The user in this case had elected to set up 
a subdirectory for handling incoming mail. 

The environment variables shown in this section are those most commonly included 
in the .mailrc file. You can, however, specify any of them for one session only when- 
ever you are in command mode. For a complete list of the environment variables you 
can set in mailx see the mailx(l) manual page in the User's Reference Manual. 
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This section describes the commands available for transferring files: the mail com- 
mand for small files (a page or less), and the uucp and uuto commands for long files. 
The mail command can be used for transferring a file either within a local system or 
to a remote system. The uucp and uuto commands transfer files from one system to 
another. 



Sending Small Files: the mail Command 

To send a file in a mail message, you must redirect the input to that file on the com- 
mand line. Use the < (less than) redirection symbol as follows: 

mail login < filename<CR> 

(For further information on input redirection, see Chapter 7.) Here login is the 
recipient's login ID and filename is the name of the file you want to send. For exam- 
ple, to send a copy of a file called agenda to the owner of login sarah (on your sys- 
tem) type the following command line: 

$ mail sarah < agenda<CR> 

$ 

The prompt that appears on the second line means the contents of agenda have been 
sent. When sarah issues the mail command to read her messages, she will receive 
agenda. 

To send the same file to more than one user on your system, use the same command 
line format with one difference; in place of one login ID, type several, separated by 
spaces. For example: 

$ mail sarah tommy dingo wombat < agenda<CR> 

$ 

Again, the prompt returned by the system in response to your command is a signal 
that your message has been sent. 

The same command line format, with one addition, can also be used to send a file to 
a user on a remote system that can communicate with yours. In this case, you must 
specify the name of the remote system before the user's login name. Separate the 
system name and the login name with an ! (exclamation point): 

mail systemMogin < filename<CR> 

For example: 

$ mail dumbolwombat < agenda<CR> 

$ 

The system prompt on the second line means that your message (containing the file) 
has been queued for sending. 

If you are using mailx, you cannot use the mail command line syntax to send a file. 
Instead, you use the ~r option as follows: 

$ mailx phyllis 
Subject: Memo 
~r memo 

$ 
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Sending Large Files 

The uucp and unto commands allow you to transfer files to a remote computer, uucp 
allows you to send files to the directory of your choice on the destination system. If 
you are transferring a file to a directory that you own, you will have permission to put 
the file in that directory. (See Chapter 3 for information on directory and file permis- 
sions.) However, if you are transferring the file to another user's directory, you must 
be sure, in advance, that the user has given you permission to write a file to his or her 
directory. In addition, because you must specify path names that are often long and 
accuracy is required, uucp command lines may be cumbersome and lead to error. 

The uuto command is an enhanced version of uucp. It automatically sends files to a 
public directory on the recipient's system called /usr/spool/uucppublic . This means 
you cannot choose a destination file. However, it also means that you can transfer a 
file at any time without having to request write permission from the owner of the des- 
tination directory. Finally, the uuto command line is shorter and less complicated 
than the uucp command line. When you type a uuto command line, the likelihood of 
making an error is greatly reduced. 

Getting Ready: Do You Have Permission? 

Before you actually send a file with the uucp or uuto command, you need to find out 
whether or not the file is transferable. To do that, you must check the file's permis- 
sions. If they are not correct, you must use the chmod command to change them, if 
you own the files. (Permissions and the chmod command are covered in Chapter 3.) 

There are two permission criteria that must be met before a file can be transferred 
using uucp or uuto. 

■ The file to be transferred must have read permission (r) for others. 

■ The directory that contains the file must have read (r) and execute (x) permis- 
sion for others. 

For example, assume that you have a file named chicken, under a directory named 
soup (in your home directory). You want to send a copy of the chicken file to 
another user with the uuto command. First, check the permissions on soup: 

$ Is -1<CR> 

total 4 

drwxr-xr-x 2 reader groupl 45 Feb 910 : 43soup 

$ 

The response of the Is command shows that soup has read (r) and execute (x) permis- 
sions for all three groups; no changes have to be made. Now use the cd command to 
move from your home directory to soup, and check the permissions on the file 
chicken: 

$ Is -1 chicken<CR> 
total 4 

-rw • 1 reader groupl 3101 Mar 1 18 : 22 chicken 

$ 

The command's output means that you (the user) have permission to read the file 
chicken, but no one else does. To add read permissions for your group (g) and oth- 
ers (o), use the chmod command: 
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$ chmod go+r chicken<CR> 

Now check the permissions again with the Is -1 command: 

$ Is -1 chicken<CR> 

total 4 

-rw~r — r — 1 reader group 1 3101 MarOl 18:22 chicken 
$ 

This confirms that the file is now transferable; you can send it with the uucp or uuto 
command. After you send copies of the file, you can reverse the procedure and 
replace the previous permissions. 



The uucp Command 

The command uucp (short for UMIPS-to-UMIPS system copy) allows you to copy a 
file directly to the home directory of a user on another computer, or to any other 
directory you specify and for which you have write permission. 

uucp is not an interactive command. It performs its work silently, invisible to the 
user. Once you issue this command you may run other processes. 

Transferring a file between computers is a multiple-step procedure. First, a work file, 
containing instructions for the file transfer, must be created. When requested, a data 
file (a copy of the file being sent) is also made. Then the file is ready to be sent. 
When you issue the uucp command, it performs the preliminary steps described 
above (creating the necessary files in a dedicated directory called a spool directory), 
and then calls the uucico daemon that actually transfers the file. (Daemons are sys- 
tem processes that run in background.) The file is placed in a queue and uucico 
sends it at the first available time. 

Thus, the uucp command allows you to transfer files to a remote computer without 
knowing anything except the name of the remote computer and, possibly, the login ID 
of the remote user(s) to whom the file is being sent. 



Command Line Syntax 

uucp allows you to send: 

■ one file to a file or a directory or 

■ multiple files to a directory 

To deliver your file(s), uucp must know the full path name of both the source-file and 
the destination-file. However, this does not mean you must type out the full path 
name of both files every time you use the uucp command. There are several abbrevia- 
tions you can use once you become familiar with their formats; uucp will expand 
them to full path names. 

To choose the appropriate designations for your source-file and destination-file, begin 
by identifying the source-file's location relative to your own current location in the file 
system. (We'll assume, for the moment, that the source-file is in your local system.) 
If the source-file is in your current directory, you can specify it by its name alone 
(without a path). If the source-file is not in your current directory, you must specify its 
full path name. 
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How do you specify the destination-file! Because it is on a remote system, the 
destination-file must always be specified with a path name that begins with the name 
of the remote system. After that, however, uucp gives you a choice: you can specify 
the full path or use either of two forms of abbreviation. Your destination-file should 
have one of the following three formats: 

■ systemjnamelfulljpath 

■ systemjname\~loginjname [I directory enamel filename] 

■ systemnameriloginjname [/directory_name/filename] 

The login name, in this case, belongs to the recipient of the file. 

Until now we have described what to do when you want to send a file from your local 
system to a remote system. However, it is also possible to use uucp to send a file 
from a remote system to your local system. In either case, you can use the formats 
described above to specify either source-files or destination-files. The important dis- 
tinction in choosing one of these formats is not whether a file is a source-file or a 
destination- file, but where you are currently located in the file system relative to the 
files you are specifying. Therefore, in the formats shown above, the loginjname 
could refer to the login of the owner or the recipient of either a source-file or a 
destination-file. 

For example, let's say you are login kol on a system called mickey. Your home direc- 
tory is /usr/kol and you want to send a file called chapl (in a directory called text in 
your home directory) to login wsm on a system called minnie. You are currently 
working in /usr/kol/text, so you can specify the source-file with its relative path 
name, chapl. Specify the destination-file in any of the ways shown in the following 
command lines: 

■ Specify the destination-file with its full path name: 
uucp chapl minnie!/usr/wsm/receive/chapl 

■ Specify the destination-file with ~loginjname (which expands to the name of the 
recipient's home directory) and a name for the new file. 

uucp chapl minnierwsm/receive/chapl 

(The file will go to minnie!/usr/wsm/receive/chapl .) 

■ Specify the destination-file with loginjname (which expands to the recipient's 
home directory) but without a name for the new file; uucp will give the new file 
the same name as the source-file. 

uucp chapl minnie!~wsm/receive 

(The file will go to minnie!/usr/wsni/receive/chapl.) 

■ Specify the destination-file with ~ /loginjname. This expands to the recipient's 
subdirectory in the public directory on the remote system. 

uucp chapl minnie!~/wsm 

(The file will go to minnie!/usr/usr/spool/uucppublic/wsm) 
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Sample Usage of Options with the uucp Command 

Suppose you want to send a file called minutes to a remote computer named eagle. 
Enter the command line shown in the following example: 

$ uucp — m — s status — j minutes eagle!/usr/gws/minutes<CR> 

eagleN3f 45 
$ 

This sends the file minutes (located in your current directory on your local computer) 
to the remote computer eagle, and places it under the path name /usr/gws in a file 
named minutes. When the transfer is complete, the user gws on the remote com- 
puter is notified by mail. 

The — m option ensures that you (the sender) are also notified by mail as to whether 
or not the transfer has succeeded. The — s option, followed by the name of the file 
(status), asks the program to put a status report of the file transfer in the specified file 
(status). 



Be sure to include a file name after the — s option. If you do not, you will get this 
message: uucp failed completely. 



The job ID (eagleN3f45) is displayed in response to the — j option. 

Even if uucp does not notify you of a successful transfer soon after you send a file, 
do not assume that the transfer has failed. Not all systems equipped with networking 
software have the hardware needed to call other systems. Files being transferred 
from these so called passive systems must be collected periodically by active systems 
equipped with the required hardware (see "How the uucp Command Works" for 
details). Therefore, if you are transferring files from a passive system, you may 
experience some delay. Check with your system administrator to find out whether 
your system is active or passive. 

The previous example uses a full path name to specify the destination-file. There are 
two other ways the destination-file can be specified: 

■ The login directory of gws can be specified through use of the ~ (tilde), as 
shown below: 

eaglel^gws/minutes 

is interpreted as: 

eagle!/usr/gws/minutes 



■ The uucppuhlic area is referenced by a similar use of the tilde prefix to the 
path name. For example: 

eagle! Wgws/minutes 

is interpreted as: 

/usr/spool/uucppublic/gws/minutes 
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How the uucp Command Works 

This section is an overview of what happens when you issue the uucp command. An 
understanding of the processes involved may help you to be aware of the command's 
limitations and requirements: why it can perform some tasks and not others, why it 
performs tasks when it does, and why you may or may not be able to use it for tasks 
that uucp performs. For further details see the System Administrator's Guide and the 
System Administrator's Reference Manual. 

When you enter a uucp command, the uucp program creates a work file and usually a 
data file for the requested transfer, (uucp does not create a data file when you use 
the — c option.) The work file contains information required for transferring the 
file(s). The data file is simply a copy of the specified source file. After these files are 
created in the spool directory, the uucico daemon is started. 

The uucico daemon attempts to establish a connection to the remote computer that is 
to receive the file(s). It first gathers the information required for establishing a link to 
the remote computer from the Systems file. This is how uucico knows what type of 
device to use in establishing the link. Then uucico searches the Devices file looking 
for the devices that match the requirements listed in the Systems file. After uucico 
finds an available device, it attempts to establish the link and log in on the remote 
computer. 

When uucico logs in on the remote computer, it starts the uucico daemon on the 
remote computer. The two uucico daemons then negotiate the line protocol to be 
used in the file transfer(s). The local uucico daemon then transfers the file(s) that 
you are sending to the remote computer; the remote uucico places the file in the 
specified path name(s) on the remote computer. After your local computer com- 
pletes the transfer(s), the remote computer may send files that are queued for your 
local computer. The remote computer can be denied permission to transfer these 
files with an entry in the Permissions file. If this is done, the remote computer must 
establish a link to your local computer to perform the transfers. 

If the remote computer or the device selected to make the connection to the remote 
computer is unavailable, the request remains queued in the spool directory. Each 
hour (default), uudemon.hour is started by cron which in turn starts the uusched dae- 
mon. When the uusched daemon starts, it searches the spool directory for the 
remaining work files, generates the random order in which these requests are to be 
processed, and then starts the transfer process (uucico) described in the previous 
paragraphs. 

The transfer process described generally applies to an active computer. An active 
computer (one with calling hardware and networking software) can be set up to poll a 
passive computer. Because it has networking software, a passive computer can queue 
file transfers. However, it cannot call the remote computer because it does not have 
the required hardware. The Poll file (/usr/lib/uucp/Poll) contains a list of computers 
that are to be polled in this manner. 

Figure 8-6 summarizes the syntax and capabilities of the uucp command. 
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Command Recap 


uucp 


- copies a file from one computer to another 


command 


options arguments 


uucp 


— jl, — m, — s and others* source-file 


Description: 


uucp performs preliminary tasks required to 
copy a file from one computer to another, and 
calls uucico, the daemon (background pro- 
cess) that transfers the file. The user need 
only issue the uucp command for a file to be 
copied. 


Remarks: 


By default, the only directory to which you can 
write files is /usr/spool/uucppublic . To write 
to directories belonging to another user, you 
must receive write permission from that user. 
Although there are several ways of represent- 
ing path names as arguments, it is recom- 
mended that you type full path names to avoid 
confusion. 



See the uucp(l) manual page in the User's Reference Manual for all 
available options and an explanation of their capabilities. 

Figure 8-6: Summary of the uucp Command 



The uuto Command 

The uuto command allows you to transfer files to the public directory of another sys- 
tem. The basic format for the uuto command is: 

uuto filename systemllogin<CR> 

where filename is the name of the file to be sent, system is the recipient's system, and 
login is the recipient's login name. 

If you send a file to someone on your local system, you may omit the system name 
and use the following format: 

uuto filename login<CR> 
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Sending a File: the -m Option and uustat Command 

Now that you know how to determine if a file is transferable, let's take an example 
and see how the whole thing works. 

The process of sending a file by uuto is referred to as a job. When you issue a uuto 
command, your job is not sent immediately. First, the file is stored in a queue (a 
waiting line of jobs) and assigned a job number. When the job's number comes up, 
the file is transmitted to the remote system and placed in a public directory there. 
The recipient is notified by a mail message and must use the uupick command (dis- 
cussed later in the chapter) to retrieve the file. 

For the following discussions, assume this information: 

wombat your login name 

sysl your system name 

marie recipient's login name 

sys2 recipient's system name 

money file to be sent 

Also assume that the two systems can communicate with each other. 

To send the file money to login marie on system sys2, enter the following: 

$ uuto money sys2!marie<CR> 

$ 

The prompt on the second line is a signal that the file has been sent to a job queue. 
The job is now out of your hands; all you can do is wait for confirmation that the job 
reached its destination. 

How do you know when the job has been sent? The easiest method is to alter the 
uuto command line by adding a — m option, as follows: 

$ uuto — m money sys2!marie<CR> 
$ 

This option sends a mail message back to you when the job has reached the 
recipient's system. The message may look something like this: 

$ mail<CR> 

From uucp Thur Apr 3 09: 45 EST 1986 
file /sy s 1/wombat/money , system sysl 
copy succeeded 
? 

If you would like to check if the job has left your system, you can use the uustat com- 
mand. This command keeps track of all the uucp and uuto jobs you submit and 
reports the status of each on demand. For example: 

$ uustat<CR> 

1145 wombat sys2 10/05-09: 31 10/05-09: 33 JOB IS QUEUED 
$ 

The elements of this sample status message are as follows: 
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■ 1145 is the job number assigned to the job of sending the file money to marie 
on sys2. 

■ wombat is the login name of the person requesting the job. 

■ sys2 is the recipient's system. 

■ 10/05-09 : 31 is the date and time the job was queued. 

■ 10/05-09 : 33 is the date and time this uustat message was sent. 

■ The final part is a status report on the job. Here the report shows that the job 
has been queued, but has not yet been sent. 

To receive a status report on only one uuto job, use the — j option and specify the job 
number on the command line: 

uustat —$jobnumber<CR> 

For example, to get a report on the job described in the previous example, specify 
il45 (the job number) after the — j option: 

$ uustat -jll45<CR> 

1145 wombat sys2 10/05-09:31 10/05-09:37 COPY FINISHED, JOB 

DELETED 

$ 

This status report shows that the job was sent and deleted from the job queue; it is 
now in the public directory of the recipient's system. Other status messages and 
options for the uustat command are described under uustat(l) in the User's Reference 
Manual 

That is all there is to sending files. To practice, try sending a file to yourself. 

Figures 8-7 and 8-8 summarize the syntax and capabilities of the uuto and uustat com- 
mands, respectively. 
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Command Recap 




uuto - sends files to another login 


command 


options arguments 


unto 


m and others* file system f loirin 


Description: 


uuto sends a specified file to the public direc- 
tory of a specified system, and notifies the 
intended recipient (by mail addressed to his or 
her login) that the file has arrived there. 


Remarks: 


Files to be sent must have read permission for 
others; the file's parent directory must have 
read and execute permissions for others. 

The — m option notifies the sender by mail 
when the file has arrived at its destination. 



See the uuto(l) manual page in the User's Reference Manual for all 
available options and an explanation of their capabilities. 



Figure 8-7: Summary of the uuto Command 
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Command Recap 


uustat 


- checks job status of a uucp or uuto job 


command 


options arguments 


uustat 


— j and others* none 


Description: 


uustat reports the status of all uucp and uuto 

jobs you have requested. 


Remarks: 


The — j option, followed by a job number, 
allows you to request a status report on only 
the specified job. 



* See the uustat(l) manual page in the User's Reference Manual for all 
available options and an explanation of their capabilities. 

Figure 8-8: Summary of the uustat Command 



Receiving Files Sent with uuto: the unpick Command 

When a file sent by uuto reaches the public directory on your UMIPS system, you 
receive a mail message. To continue the previous example, the owner of login marie 
receives the following mail message when the file money has arrived in her system's 
public directory: 

$ mail 

From uucp Wed May 14 09:22 EST 1986 

/usr/spool/uucppublic/receive/marie/sysl//money from 

sysl! wombat arrived 

$ 

The message contains the following pieces of information: 

■ The first line tells you when the file arrived at its destination. 

■ The second line, up to the two slashes (//), gives the path name to the part of 
the public directory where the file has been stored. 

■ The rest of the line (after the two slashes) gives the name of the file and the 
sender. 

Once you have disposed of the mail message, you can use the uupick command to 
store the file where you want it. Type the following command after the system 
prompt: 

uupick<CR> 

The command searches the public directory for any files sent to you. If it finds any, it 
reports the filename(s). It then prints a ? prompt as a request for further instructions 
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from you. 

For example, say the owner of login marie issues the uupick command to retrieve the 
money file. The command will respond as follows: 

$ uupiek<CR> 

from system sysl : file money 

? 

There are several available responses; we will look at the most common responses 
and what they do. 

The first thing you should do is move the file from the public directory and place it in 
your login directory. To do so, type an m after the question mark: 

m<CR> 

$ 

This response moves the file into your current directory. If you want to put it in 
some other directory instead, follow the m response with the directory name: 

? 

m other m directory<CR> 

If there are other files waiting to be moved, the next one is displayed, followed by the 
question mark. If not, uucpick, returns a prompt. 

If you do not want to do anything to that file now, press the RETURN key after the 
question mark: 

? 

<CR> 

The current file remains in the public directory until the next time you use the uupick 
command. If there are no more messages, the system returns a prompt. 

If you already know that you do not want to save the file, you can delete it by typing d 
after the question mark: 

? 

d<CR> 

This response deletes the current file from the public directory and displays the next 
message (if there is one). If there are no additional messages about waiting files, the 
system returns a prompt. 

Finally, to stop the uupick command, type a q after the question mark: 

? 

q<CR> 

Any unmoved or undeleted files will wait in the public directory until the next time 
you use the uupick command. 

Other available responses are listed in the User's Reference Manual. 
Figure 8-9 summarizes the syntax and capabilities of the uupick command. 
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f nfYimsififl Ri*<*iin 


uupick 


- searches for files sent by uuto or uucp 


command 


options arguments 


uupick 


s sysiem name 


Description: 


uupick searches the public directory of your 
system for files sent by uuto or uucp. If any 
are found, the command displays information 
about the file and prompts you for a response. 


Remarks: 


The question mark (?) at the end of the mes- 
sage shows that a response is expected. A 
complete list of responses is given in the 
User's Reference Manual. 



Figure 8-9: Summary of the uupick Command 
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Networking is the process of linking computers and terminals so that users may be 
able to: 

■ log in on a remote computer as well as a local one 

■ log in and work on two computers in one work session (without alternately log- 
ging off one and logging in on the other) 

■ exchange data between computers 

The commands presented in this section make it possible for you to perform these 
tasks. The ct command allows you to connect your computer to a remote terminal 
that is equipped with a modem. The cu command enables you to connect your com- 
puter to a remote computer, and the uux command lets you run commands on a 
remote system, without being logged in on it. 

Connecting a Remote Terminal: the ct Command 

The ct command connects your computer to a remote terminal equipped with a 
modem, and allows a user on that terminal to log in. To do this, the command dials 
the phone number of the modem. The modem must be able to answer the call 
automatically. When ct detects that the call has been answered, it issues a getty 
(login) process for the remote terminal and allows a user on it to log in on the com- 
puter. 

This command can be useful when issued from the opposite end, that is, from the 
remote terminal itself. If you are using a remote terminal that is far from your com- 
puter and want to avoid long distance charges, you can use ct to have the computer 
place a call to your terminal. Simply call the computer, log in, and issue the ct com- 
mand. The computer will hang up the current line and call your (remote) terminal 
back. 

If ct cannot find an available dialer, it tells you that all dialers are busy and asks if it 
should wait until one becomes available. If you answer yes, it asks how long (in 
minutes) it should wait for one. 

Command Line Format 

To execute the ct command, follow this format: 

ct [options] telno<CR> 
The argument telno is the telephone number of the remote terminal. 

Sample Command Usage 

Suppose you are logged in on a computer through a local terminal and you want to 
connect a remote terminal to your computer. The phone number of the modem on 
the remote terminal is 932-3497. Enter this command line: 

ct -h -w5 -sl200 9=9323497<CR> 
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T 



The equal sign (=) represents a secondary dial tone, and dashes (-) following the 
phone number represent delays (the dashes are useful following a long distance 
number). 



ct will call the modem, using a dialer operating at a speed of 1200 baud. If a dialer is 
not available, the -w5 option will cause ct to wait for a dialer for five minutes before 
quitting. The -h option tells ct not to disconnect the local terminal (the terminal on 
which the command was issued) from the computer. 

Now imagine that you want to log in on the computer from home. To avoid long dis- 
tance charges, use ct to have the computer call your terminal: 

ct -sl200 9=9323497<CR> 

Because you did not specify the -w option, if no device is available, ct sends you the 
following message: 

1 busy dialer at 1200 baud Wait for dialer? 

If you type n (no), the ct command exits. If you type y (yes), ct prompts you to 
specify how long ct should wait: 

Time, in minutes? 

If a dialer is available, ct responds with: 

Allocated dialer at 1200 baud 

This means that a dialer has been found. In any case, ct asks if you want the line 
connecting your remote terminal to the computer to be dropped: 

Confirm hangup? 

If you type y (yes), you are logged off and ct calls your remote terminal back when a 
dialer is available. If you type n (no), the ct command exits, leaving you logged in on 
the computer. 

Figure 8-10 summarizes the syntax and capabilities of the ct command. 
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Command Recap 


ct - 


connect computer to remote terminal 


command 


options arguments 


ct 


— h, — w, — s and others* telno 


Description: 


ct connects the computer to a remote terminal 
and allows a user to log in from that terminal. 


Remarks: 


The remote terminal must have a modem 
capable of answering phone calls automati- 
cally. 



See the ct(l) manual page in the User's Reference Manual for all 
available options and an explanation of their capabilities. 



Figure 8-10: Summary of the ct Command 



Calling Another UMIPS System: the cu Command 

The cu command connects a remote computer to your computer and allows you to be 
logged in on both computers simultaneously. This means that you can move back and 
forth between the two computers, transferring files and executing commands on both, 
without dropping the connection. 

The method used by the cu command depends on the information you specify on the 
command line. You must specify the telephone number or system name of the 
remote computer. If you specify a phone number, it is passed on to the automatic 
dial modem. If you specify a system name, cu obtains the phone number from the 
Systems file. If an automatic dial modem is not used to establish the connection, the 
line (port) associated with the direct link to the remote computer can be specified on 
the command line. 

Once the connection is made, the remote computer prompts you to log in on it. 
When you have finished working on the remote terminal, log off it and terminate the 
connection by typing <~.>. You will still be logged in on the local computer. 



NOTE 



The cu command is not capable of detecting or correcting errors; data may be lost or 
corrupted during file transfers. After a transfer, you can check for loss of data by 
running the sum command or the Is — 1 command on the file that was sent and the file 
that was received. Both of these commands will report the total number of bytes in 
each file; if the totals match, your transfer was successful. The sum command checks 
more quickly and gives output that is easier to interpret. (See the sum(l) and the 
ls(l) manual pages in the User's Reference Manual for details.) 
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Command Line Format 

To execute the cu command, follow this format: 

cu [options] telno \ systemname<CR> 
The components of the command line are: 

telno the telephone number of a remote computer 

Equal signs (=) represent secondary dial tones and dashes (-) 
repreent four-second delays. 

systemname a system name that is listed in the Systems file. 

The cu command obtains the telephone number and baud rate 
from the Systems file and searches for a dialer. The — s, — n, and 
—1 options should not be used together with systemname. (To see 
the list of computers in the Systems file, run the uuname com- 
mand.) 

Once your terminal is connected and you are logged in on the remote computer, all 
standard input (input from the keyboard) is sent to the remote computer. Figure 8-11 
shows the commands you can execute while connected to a remote computer through 
cu. 
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String 


Interpretation 




Terminate the link, 




Escape to the local computer without dropping 
the link. To return to the remote computer, 
type ~d (control-d) . 


^Icommand 


Execute command on the local computer. 


^%command 


Run command locally and send its output to 
the remote system. 


~%cd path 


Change the directory on the local computer 
where path is the path name or directory 
name. 


^%take from [to] 


Copy a file named from (on the remote com- 
puter) to a file named to (on the local com- 
puter). If to is omitted, the from argument is 
used in both places. 


^%put from [to] 


Copy a file named from (on the local com- 
puter) to a file named to (on the remote com- 
puter). If to is omitted, the from argument is 
used in both places. 




Send a line beginning with ~ ("•"*'...) to the 
remote computer. 


""%break 


Transmit a BREAK to the remote computer 
(can also be specified as ^%b). 



Figure 8-11: Command Strings for Use with cu (Sheet 1 of 2) 
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String 


Interpretation 


^%nostop 


Turn off the handshaking protocol for the 
remainder of the session. This is useful when 
the remote computer does not respond prop- 
erly to the protocol characters. 


^%debug 


Turn the -d debugging option on or off (can 
also be specified as ~%d). 


~t 


Display the values of the terminal I/O 
(input/output) structure variables for your ter- 
minal (useful for debugging). 


-1 


Display the values of the termio structure vari- 
ables for the remote communication line (use- 
ful for debugging). 



Figure 8-11: Command Strings for Use with cu (Sheet 2 of 2) 



The use of ~%put requires stty and cat on the remote computer. It also requires that 
the current erase and kill characters on the remote computer be identical to the 
current ones on the local computer. 

The use of /w %take requires the existence of the echo and cat commands on the 
remote computer. Also, stty tabs mode should be set on the remote computer if tabs 
are to be copied without expansion. 



Sample Command Usage 

Suppose you want to connect your computer to a remote computer called eagle. The 
phone number for eagle is 847-7867. Enter the following command line: 

cu -sl200 9=8477867<CR> 

The -sl200 option causes cu to use a 1200 baud dialer to call eagle. If the — s option 
is not specified, cu uses a dialer at the default speed, 300 baud. 

When eagle answers the call, cu notifies you that the connection has been made, and 
prompts you for a login ID: 

connected 
login : 

Enter your login ID and password. 

The take command allows you to copy files from the remote computer to the local 
computer. Suppose you want to make a copy of a file named proposal for your local 
computer. The following command copies proposal from your current directory on 
the remote computer and places it in your current directory on the local computer. If 
you do not specify a file name for the new file, it will also be called proposal. 

""%take proposal<CR> 
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The put command allows you to do the opposite: copy files from the local computer 
to the remote computer. Say you want to copy a file named minutes from your 
current directory on the local computer to the remote computer. Type: 

^%put minutes minutes.9— 18<CR> 

In this case, you specified a different name for the new file (minutes.9- 18). Therefore 
the copy of the minutes file that is made on the remote computer will be called 
minutes.9-18. 

Figure 8-12 summarizes the syntax and capabilities of the cu command. 





Command Recap 


cu - 


connects computer to remote computer 


command 


options arguments 


cu 


— s and others* telno (or) systemname 


Description: 


cu connects your computer to a remote com- 
puter and allows you to be logged in on both 
simultaneously. Once you are logged in, you 
can move between computers to execute com- 
mands and transfer files on each without drop- 
ping the link. 



See the cu(l) manual page in the User's Reference Manual for all 
available options and an explanation of their capabilities. 



Figure 8-12: Summary of the cu Command 



Executing Commands on a Remote System: the uux 
Command 

The command uux (short for UMIPS-to-UMIPS system command execution) allows 
you to execute UMIPS system commands on remote computers. It can gather files 
from various computers, execute a command on a specified computer, and send the 
standard output to a file on a specified computer. The execution of certain com- 
mands may be restricted on the remote machine. The command notifies you by mail 
if the command you have requested is not allowed to execute. 

Command Line Format 

To execute the uux command, follow this format: 

uux [options] command- string<QJL> 
The command— string is made up of one or more arguments. All special shell 
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characters (such as "<>| A ") must be quoted either by quoting the entire 
command -string or quoting the character as a separate argument. Within the 
command-string the command and file names may contain a system name! prefix. All 
arguments that do not contain a systemname are interpreted as command arguments. 
A file name may be either a full path name or the name of a file under the current 
directory (on the local computer). 

Sample Command Usage 

If your computer is hard-wired to a larger host computer you can use uux to get prin- 
touts of files that reside on your computer by entering: 

pr minutes | uux — p host!lp<CR> 

This command line queues the file minutes to be printed on the area printer of the 
computer host. 

Figure 8-13 summarizes the syntax and capabilities of the uux command. 





Command Recap 


uux - 


executes commands on a remote computer 


command 


options arguments 


uux 


— 1, — p, and others* command-string 


Description: 


uux allows you to run UMIPS system com- 
mands on remote computers. It can gather 
files from various computers, run a command 
on a specified computer, and send the stan- 
dard output to a file on a specified computer. 


Remarks: 


By default, users of the uux command have 
permission to run only the mail and mailx 
commands. Check with your system adminis- 
trator to find out if users on your system have 
been granted permission to run other com- 
mands. 



* See the uux(l) manual page in the User's Reference Manual for all 
available options and an explanation of their capabilities. 

Figure 8-13: Summary of the uux Command 
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Introduction 



This document describes Csh, a command language interpreter for UMIPS systems. 
The document is based on An Introduction to the C shell written by William Joy, as 
revised for 4.3BSD by Mark Seiden. This document has been modified to reflect 
operations under UMIPS. 

The csh command line interpreter incorporates good features of other shells and a 
history mechanism similar to the redo of INTERLISP. While incorporating many 
features of other shells which make writing shell programs (shell scripts) easier, most 
of the features unique to csh are designed more for the interactive UMIPS user. This 
document is divided into the following major sections: 

■ Using the Shell Interactively 

■ Terminal User Reference 

■ Control Structures and Command Scripts 

■ Miscellaneous Shell Features 

■ Glossary 

A shell is a command language interpreter. Csh is the name of one particular com- 
mand interpreter on UMIPS. The primary purpose of csh is to translate command 
lines typed at a terminal into system actions, such as invocation of other programs. 
Csh is a user program just like any you might write. 

In addition to this document, you may need to refer to the User's Reference Manual. 
The csh documentation in section 1 of the manual provides a full description of a 
features of the shell and is the definitive reference for questions about the shell. 

UMIPS commands referenced in this document are in bold-face type; other words 
that These are important words have special meaning in discussing the shell and 
UMIPS are printed in italics. Many of the words are defined in a glossary at the end 
of this document. If you don't know what is meant by a word, you should look for it 
in the glossary. 
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Command Basics 

A shell in UMIPS acts mostly as a medium through which other programs are 
invoked. While it has a set of builtin functions which it performs directly, most com- 
mands cause execution of programs that are, in fact, external to the shell. The shell is 
thus distinguished from the command interpreters of other systems both by the fact 
that it is just a user program, and by the fact that it is used almost exclusively as a 
mechanism for invoking other programs. 

Commands in the UMIPS system consist of a list of strings or words interpreted as a 
command name followed by arguments. Thus the command 

mail bill 

consists of two words. The first word mail names the command to be executed, in 
this case the mail program which sends messages to other users. The shell uses the 
name of the command in attempting to execute it for you. It looks in a number of 
directories for a file with the name mail which is expected to contain the mail pro- 
gram. 

The rest of the words of the command are given as arguments to the command itself 
when it is executed. In this case we specified also the argument bill which is inter- 
preted by the mail program to be the name of a user to whom mail is to be sent. In 
normal terminal usage we might use the mail command as follows. 

% mail bill 

I have a question about the csh documentation. 
My document seems to be missing page 5. 
Does a page five exist? 
Bill 

EOT 
% 

Here we typed a message to send to bill and ended this message with a D which sent 
an end-of-file to the mail program. The mail program then echoed the characters 
'EOT' and transmitted our message. The characters '% ' were printed before and 
after the mail command by the shell to indicate that input was needed. 

After typing the '% ' prompt the shell was reading command input from our terminal. 
We typed a complete command 'mail bill'. The shell then executed the mail program 
with argument bill and went dormant waiting for it to complete. The mail program 
then read input from our terminal until we indicated an end-of-file via typing a A D 
after which the shell noticed that mail had completed and signaled us that it was ready 
to read from the terminal again by printing another '% ' prompt. 

This is the essential pattern of all interaction with UMIPS through the shell. A com- 
plete command is typed at the terminal, the shell executes the command and when 
this execution completes, it prompts for a new comma If you run the editor for an 
hour, the shell waits for you to finish editing and obediently prompt you again when- 
ever you finish editing. 



9-2 USER'S GUIDE 



Using the C Shell Interactively 



Flag Arguments 

A useful notion in UMIPS is that of a flag argument. While many arguments to com- 
mands specify file names or user names, some arguments rather specify an optional 
capability of the command which you wish to invoke. By convention, such arguments 
begin with the character (hyphen). Thus the command 

Is 

produces a list of the files in the current working directory. The option -s is the size 
option, and 

Is -s 

causes Is to also give, for each file, the size of the file in blocks of 512 characters. 
Refer to the User's Reference Manual for the options available with Is. The Is com- 
mand has a large number of useful and interesting options. Most other commands 
have either no options or only one or two options. It is hard to remember options of 
commands which are not used very frequently, so most UMIPS utilities perform only 
one or two functions rather than having a large number of hard to remember options. 

Output to Files 

Commands that normally read input or write output on the terminal can also be exe- 
cuted with this input and/or output done to a file. 

Thus suppose we wish to save the current date in a file called 'now'. The command 
date 

prints the current date on our terminal. This is because our terminal is the default 
standard output for the date command and the date command prints the date on its 
standard output. The shell lets us redirect the standard output of a command through 
a notation using the metacharacter and the name of the file where output is to be 
placed. Thus the command 

date > now 

runs the date command such that its standard output is the file 'now' rather than the 
terminal. Thus this command places the current date and time into the file 'now'. It is 
important to know that the date command was unaware that its output was going to a 
file rather than to the terminal. The shell performed this redirection before the com- 
mand began executing. 

One other thing to note here is that the file 'now' need not have existed before the 
date command was executed; the shell would have created the file if it did not exist. 
And if the file did exist? If it had existed previously these previous contents would 
have been disc A shell option noclobber exists to prevent this from happening 
accidentally; it is discussed in the section "Shell Variables" later in this chapter. 
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Metacharacters in the Shell 

The shell has a large number of special characters (like '>') which indicate special 
functions. We say that these notations have syntactic and semantic meaning to the 
shell. In general, most characters which are neither letters nor digits have special 
meaning to the shell. We shall shortly learn a means of quotation which allows us to 
use metacharacters without the shell treating them in any special way. 

Metacharacters normally have effect only when the shell is reading our input. We 
need not worry about placing shell metacharacters in a letter we are sending via mail, 
or when we are typing in text or data to some other program. Note that the shell is 
only reading input when it has prompted with '% ' (although we can type our input 
even before it prompts). 



Input from Files: Pipelines 

We learned above how to redirect the standard output of a command to a file. It is 
also possible to redirect the standard input of a command from a file. This is not 
often necessary since most commands read from a file whose name is given as an 
argument. We can give the command 

sort < data 

to run the sort command with standard input, where the command normally reads its 
input, from the file 'data'. We would more likely say 

sort data 

letting the sort command open the file 'data' for input itself since this is less to type. 
We should note that if we just typed 
sort 

then the sort program would sort lines from its standard input. Since we did not 
redirect the standard input, it would sort lines as we typed them on the terminal until 
we typed a A D to indicate an end-of-file. 

A most useful capability is the ability to combine the standard output of one com- 
mand with the standard input of another, i.e. to run the commands in a sequence 
known as a pipeline. For instance, the command 

Is -s 

normally produces a list of the files in our directory with the size of each in blocks of 
512 characters. If we are interested in learning which of our files is largest we may 
wish to have this sorted by size rather than by name, which is the default way in 
which Is sorts. We could look at the many options of Is to see if there was an option 
to do this but would eventually discover that there is not. Instead we can use a couple 
of simple options of the sort command, combining it with Is to get what we want. 

The — n option of sort specifies a numeric sort rather than an alphabetic sort. Thus 
Is -s | sort -n 
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specifies that the output of the Is command run with the option — s is to be piped to 
the command sort run with the numeric sort option. This would give us a sorted list 
of our files by size, but with the smallest first. We could then use the -r reverse sort 
option and the tail command in combination with the previous command doing 

Is -s | sort -n -r | tail -5 

Here we have taken a list of our files sorted alphabetically, each with the size in 
blocks. We have run this to the standard input of the sort command asking it to sort 
numerically in reverse order (largest first). This output has then been run into the 
command tail which gives us the last few lines. In this case we have asked tail for the 
last 5 lines. Thus this command gives us the names and sizes of our 5 smallest files. 

The notation introduced above is called the pipe mechanism. Commands separated by 
* | ' characters are connected together by the shell and the standard output of each is 
run into the standard input of t next. The leftmost command in a pipeline normally 
takes its standard input from the terminal and the rightmost places its standard output 
on the terminal. Other examples of pipelines are given in the "History List" section of 
this document, which illustrates the use of pipes in routing information to the line 
printer. 



Filenames 

Many commands to be executed need the names of files as arguments. UMIPS path- 
names consist of a number of components separated by 7\ Each component except 
the last names a directory in which the next component resides, in effect specifying 
the path of directories to follow to reach the file. Thus the pathname 

/etc/local__hostname 



specifies a file in the directory 'etc' which is a subdirectory of the root directory 7\ 
Within this directory the file named is < locaLhostname\ A pathname that begins with 
a slash is said to be an absolute pathname since it is specified from the absolute top 
of the entire directory hierarchy of the system (the root). Pathnames which do not 
begin with 7' are interpreted as starting in the current working directory, which is, by 
default, your home directory and can be changed dynamically by the cd change direc- 
tory command. Such pathnames are said to be relative to the working directory since 
they are found by starting in the working directory and descending to lower levels of 
directories for each component of the pathname. If the pathname contains no slashes 
at all then the file is contained in the working directory itself and the pathname is the 
name of the file in this directory. Absolute pathnames have no relation to the working 
directory. 

Most filenames consist of a number of alphanumeric characters and Vs (periods). In 
fact, all printing characters except 7' (slash) may appear in filename It is inconvenient 
to have most non-alphabetic characters in filenamess because many of these have spe- 
cial meaning to the shell. The character V (period) is not a shell-metacharacter and is 
often used to separate the extension of a file name from the base of the name. Thus 

prog.c prog.o prog. errs prog. output 
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are four related files. They share a base portion of a name (a base portion being that 
part of the name that is left when a trailing 7 and following characters which are not 
V are stripped off). The file *progx ? might be the source for a C program, the file 
'prog.o' the corresponding object file, the file *prog,errs ? the errors resulting from a 
compilation of the program and the file /prog, output' the output of a run of the pro- 
gram. 

If we wished to refer to all four of these files in a command, we could use the nota- 
tion 



prog. * 



This expression is expanded by the shell, before the command to which it an argu- 
ment is executed, into a list of names which begin with 'prog.'. The character here 
matches any sequence (including the empty sequence of characters in a file name, The 
names which match are alphabetically sorted and placed in the argument list of the 
command. Thus the command 

echo prog . * 



echos the names 



prog . c prog, errs prpg.o prog. output 



Note that the names are in sorted order here, and a different order than we listed 
them above. The echo command receives four words as arguments, even though we 
only typed one word as as argument directly, The four words were generated by 
filenames expansion of the one input word. 

Other notations tot filenames expansion are also available. The character matches 
any single character in a filenames. Thus 

echo ? ?? ??? 



echos a line of filenames; first tl^ose with one character names, then those with two 
character names, and finally those with three character names. The names of each 
length are independently sorted, 

Another mechanism consists of a sequence of characters between T and T This 
metasequence matches any single character from the enclosed set, Thus 

prog. [co] 



matches 



prog . c prog . o 
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in the example above. We can also place two characters around a in this notation 
to denote a range. Thus 

chap. [1-5] 



might match files 

chap . 1 chap . 2 chap . 3 chap . 4 chap . 5 



if they existed. This is shorthand for 
chap. [12345] 



and otherwise equivalent. 

An important point to note is that if a list of argument words to a command (an argu- 
ment list) contains filenames expansion syntax, and if this filenames expansion syntax 
fails to match any existing file names, then the shell considers this to be an error and 
prints a diagnostic 

No match. 



and does not execute the command. 

Another very important point is that files with the character V at the beginning are 
treated specially. Neither or T or the mechanism matches it. This prevents 
accidental matching of the filenamess V and in the working directory which have 
special meaning to the system, as well as other files such as .cshrc which are not nor- 
mally visible. We discuss the special role of the file xshrc later. 

Another filenames expansion mechanism gives access to the pathname of the home 
directory of other users. This notation consists of the character (tilde) followed by 
another u login name. For instance the word l ~bilp would map to the pathname 
Vusr/bilP if the home directory for 'bill' was Vusr/bilP. Since, on large systems, users 
may have login directories scattered over many different disk volumes with different 
prefix directory names, this notation provides a convenient way of accessing the files 
of other users. 

A special case of this notation consists of a 4 ~' alone, e.g. '7mbox'. This notation is 
expanded by the shell into the file «mbox' in your home directory. This can be very 
useful if you have used cd to change to another directory and have found a file you 
wish to copy using cp. If I give the command 

cp thatfile 



the shell expands this command to 
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cp thatf ile /usr/bill 



since my home directory is Vusr/bill. 

There also exists a mechanism using the characters and <}' for abbreviating a set of 
words which have common parts but cannot be abbreviated by the above mechanisms 
because they are not files, are the names of files which do not yet exist, are not thus 
conveniently described. This mechanism is described in the "Argument Expansion 
Braces" section later in this document. 



Quotation 

We have already seen a number of metacharacters used by the shell. These metachar- 
acters pose a problem in that we cannot use them directly as parts of words. Thus the 
command 

echo * 



doesn't echo the character It either echos an sorted list of filenamess in the 
current working directory, or prints the message 'No match' if there are no files in the 
working directory. 

The recommended mechanism for placing characters which are neither number digits, 
7', V or in an argument word to a command is to enclose it with single quotation 
characters i.e. 

echo 



There is one special character T which is used by the history mechanism of the shell 
and which cannot be escaped by placing it within in characters. It and the character *' 
itself can be preceded by a single 'V to prevent their special meaning. Thus 

echo W 



prints 

" i 



These two mechanisms suffice to place any printing character into a word which is an 
argument to a shell command. They can be combined, as in 

echo V*" 



which prints 
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since the first 'V escaped the first and the was enclosed between characters. 



Terminating Commands 

When you are executing a command and the shell is waiting for it to complete there 
are several ways to force it to stop. For instance if you type the command 

cat /etc/pas swd 

the system prints a copy of a list of all users of the system on your terminal. This is 
likely to continue for several minutes unless you stop it. You can send an interrupt sig- 
nal to the cat command by typing <DEL> (or whatever your INTR character is) on 
your terminal, "stty -a" tells you the INTR key value. Since cat does not take any pre- 
cautions to avoid or otherwise handle this signal the interrupt causes it to terminate. 
The shell notices that cat has terminated and prompts you again with '% \ Even if 
you hit interrupt again, the shell repeats the prompt. This is because the shell handles 
interrupt signals and chooses to continue to execute commands rather than terminat- 
ing like cat did, which would have the effect of logging you out. 

Another way in which many programs terminate is when they get an end-of-file from 
their standard input. Thus the mail program in the first example above was terminated 
when we typed a T) which generates an end-of-file from the standard input. The shell 
also terminates when it gets an end-of-file printing 'logout'; UMIPS then logs you off 
the system. Since this means that typing too many A D's can accidentally log us off, the 
shell has a mechanism for preventing this. This ignoreeof option is discussed in the 
"Shell Variables" section of this chapter. 

If the standard input for a command redirected from a file, the command normally 
terminates when it reaches the end of this file. Thus if we execute 

mail bill < prepared . text 

the mail command terminates without our typing a A D. This is because it read to the 
end-of-file of our file 'prepared.texf in which we placed a message for 'bill' with an 
editor pr We could also have done 

cat prepared . text | mail bill 



since the cat command would then have written the text through the pipe to the stan- 
dard input of the mail command. When the cat command completed it would have 
terminated, closing down the pipeline and the mail command would have received an 
end-of-file from it and terminated. Using a pipe here is more complicated than 
redirecting input so we would more likely use the first form. These commands could 
also have been stopped by sending an interrupt. 

Interrupt and quit should be typed only at the beginning of a line since everything 
typed on the current line is discarded when a signal is sent from the keyboard. 
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If you write or run programs which are not fully debugged then it may be necessary to 
stop them somewhat ungracefully. This can be done by sending them a quit signal, 
sent by typing a A \. This usually causes the shell to produce a message like: 

Quit (Core dumped) 



indicating that a file 'core' has been created containing information about the running 
program' state when it terminated due to the quit signal. You can examine this file 
yourself, or forward information to the maintainer of the program telling him/her 
where the core file is. 

If you run background commands (as explained in the "Background Processes" sec- 
tion) then these commands ignore interrupt and quit signals at the terminal. To stop 
them you must use the kill command. See the "Background Processes" section for an 
example. 

The output of the following command moves off the screen as the command executes: 
cat /etc/pas swd 

The following command causes the output to halt after the screen fills so you can 
examine it: 

more /etc/pas swd 



The more program pauses after each complete screenful and types 4 — More — ' at 
which point you can hit a space to get another screenful, a return to get another line, 
a to get some help on other commands, or a 'q' to quit the more program. You 
can also use more as a filter, i.e. 

cat /etc/pas swd | more 



works just like the more simple more command above. 

For stopping output of commands not involving less or more you can use the A S key 
to stop the typeout. The typeout resumes when you hit A Q or any other key, but A Q is 
normally used because it only restarts the output and does not become input to the 
program which is running. This works well on low-speed terminals, but at 9600 baud 
it is hard to type A S and A Q fast enough to paginate the output nicely, and a program 
like less or more is usually used. 



What Now? 

We have so far seen a number of mechanisms of the shell and learned a lot about the 
way in which it operates. The remaining sections describe the internals of the shell; 
however, you should try using the before learning the internals. To try it you can log 
in to UMIPS and type the following command to the system: 
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exec /bin/csh 



If you want csh to be your default shell each time you log on, ask your system 
administrator to change your entry in the password file. For information on the file 
see passwd(l) in the User's Reference Manual. 

If you don't constantly use csh, you probably use 7bin/sh'. In fact, much of the above 
discussion is applicable to 7bin/sh'. The next section introduces many features partic- 
ular to csh so you should change your shell to csh before you begin reading it. 
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Startup and Termination 

When you log in, the shell is started by the system in your home directory and begins 
by reading commands from a file xshrc in this directory. All shells which you may 
start during your terminal session reads from this file. We will later see what kinds of 
commands are usefully placed there. For now we need not have this file and the shell 
does not complain about its absence. 

After you log in to the system, a login shell, first reads commands from .cshrc, and 
then from the file .login also in your home directory. This file contains commands 
which you wish to execute each time you log in to the UMIPS system. My .login file 
looks something like: 

set ignoreeof 

set mail= (/usr/spool/mail/bill) 
echo "$ [prompt ) users" / users 
stty intr ~C kill ~U crt 
set time=15 history=10 
msgs -f 

if (-e $mail ) then 

echo "$ [prompt } mail" 
mail 

endif 



This file contains several commands to be executed by UMIPS each time I log in. The 
first is a set command which is interpreted directly by the shell. It sets the shell vari- 
able ignoreeof which causes the shell to not log me off if I hit A D. Rather, I use the 
logout command to log off of the system. By setting the mail variable, I ask the shell 
to watch for incoming mail to me. Every 5 minutes the shell looks for this file and 
tells me if more mail has arrived there. 

Next I set the shell variable 'time' to '15' causing the shell to automatically print out 
statistics lines for commands which execute for at least 15 seconds of CPU time. The 
variable 'history' is set to 10 indicating that I want the shell to remember the last 10 
commands I type in its history list, (described later). 

I then run the 'msgs' program, which provides me with any system messages which I 
have not seen before; the '-f option here prevent it from telling me anything if there 
are no new messages. Finally, if my mailbox file exists, then I run the 'mail' program 
to process my mail. 

When the 'mail' and 'msgs' programs finish, the shell finishes processing my .login file 
and begin reading commands from the terminal, prompting for each wit '% '. When I 
log off (by giving the logout command) the shell prints 'logout' and executes com- 
mands from the file '.logout' if it exists in my home directory. After that the shell ter- 
minates and UMIPS logs me off the system. If the system is not going down, I receive 
a new log-in message. In any case, after the 'logout' message the shell is committed to 
terminate and takes no further input from my terminal. 
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Shell Variables 

The shell maintains a set of variables. We saw above the variables history and time 
which had values '10' and '15'. In fact, each shell variable has as value an array of 
zero or more strings. Shell variables may be assigned values by the set command. It 
has several forms, the most useful of which was given above and is 

set name=value 



Shell variables may be used to store values which are to be used in commands later 
through a substitution mechanism. The shell variables most commonly referenced are, 
however, referenced by the shell itself. By changing the values of these variables one 
can directly affect the behavior of the shell. 

One of the most important variables is the variable path. This variable contains a 
sequence of directory names where the shell searches for commands. The set com- 
mand with no arguments shows the value of all variables currently defined (we usually 
say set) in the shell. The default value for path shown by set might appear as follows: 



% set 




argv 


() 


cwd 


/usr/bill 


home 


/usr/bill 


path 


(/usr/net /bin /usr/bin /usr/ucb . ) 


prompt 


% 


shell 


/bin/csh 


status 


0 


term 


w60 


user 


bill 



% 



This output indicates that the variable path points to the /usr/net, /bin, /usr/bin, 
/usr/ucb, and then to the current directory. Commands which you may write might 
be in V (usually one of your directories). Commands developed at Berkeley live in 
7usr/ucb', while commands developed at Bell Laboratories live in 7bin' and 
7usr/bin\ 

A number of locally developed and user-contributed programs on the system live in 
the directories Vusr/local/bin' and Vusr/new'. All invoked shells can have access to 
these new programs by placing the command 

set path=( /usr/net /bin /usr/bin /usr/net /usr/local/bin /usr/new. ) 

in the user's file xshrc in the user's home directory. Try doing this and then logging 
out and back in and do 

set 



again to see that the value assigned to path has changed. 
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One thing you should be aware of is that the shell examines each directory which you 
insert into your path and determines which commands are contain there. Except for 
the current directory '.', which the shell treats differ ently, this means that if com- 
mands are added to a directory in your search path after you have started the shell, 
they aren't necessarily found by the shell If you wish to use a command which has 
been added in this way, you should give the command 

rehash 



to the shell, which causes it to recompute its internal table of command locations, so 
that it finds the newly added command. Because the shell looks in the current direc- 
tory '/on each command, placing it at the end of the path specification usually pro- 
duces the same results and reduces overhead. 

Other useful built in variables are the variable home which shows your home direc- 
tory, cwd which contains your current working directory, the variable ignoreeof which 
can be set in your .login file to tell the shell not to exit when it receives an end-of-file 
from a terminal (as described above). The variable Hgtxoreeof is one of several vari- 
ables which the shell does not care about the value of, only whether they are set or 
unset. Thus to set this variable you simply do 

set ignoreeof 



and to unset it do 

unset ignoreeof 



These give the variable 'ignoreeof no value, but none is desired or required. 

Finally, some other built-in shell variables of use are the variables noclobber and 
mail. The metasyntax 

> filename 



which redirects the standard output of a command overwrites and destroys the previ- 
ous contents of the named file. In this way you may accidentally overwrite a file which 
is valuable. If you would prefer that the shell not overwrite files in this way you can 

set noclobber 



in your .login file. Then trying to execute 
date > now 



would cause a diagnostic if 'now' existed already. You could type 
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date > ! now 



if you really wanted to overwrite the contents of 'now'. The '>!' is a special metasyn- 
tax indicating that clobbering the file is ok. 

The space between the T and the word 'now' is critical here, as Mn would be an invo- 
cation of the history mechanism, and have a totally different effect. 



History List 

The shell can maintain a history list into which it places the words of previous com- 
mands. It is possible to use a notation, to reuse commands or words from commands 
in forming new commands. This mechanism can be used to repeat previous com- 
mands or to correct minor typing mistakes in commands. 

The following figure gives a sample session involving typical usage of the history 
mechanism of the shell. 

% cat bug . c 
main() 

{ 

print f ("hello) / 

} 

% cc !$ 
cc bug . c 

"bug . c", line 4: newline in string or char constant 

"bug . c" f line 5: syntax error 

% ed !$ 

ed bug . c 

29 

4s/);/"&/p 

printf ("hello") / 

w 
30 

q 

% !c 

cc bug . c 
% a . out 
hello% !e 
ed bug . c 
30 

4s/lo/lo\\n/p 

printf ( "hello\n" ) / 

w 
32 

q 

% ! c -o bug 

cc bug . c -o bug 
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% size a . out bug 
Size of a.out: 16704 

Section Size Physical Address Virtual Address 



. text 


12800 


4194672 






4194672 


. init 


32 


4207472 






4207472 


. rdata 


368 


268435456 






268435456 


. data 


16 


268435824 






268435824 


. sdata 


1024 


268435840 






268435840 


. sbss 


400 


268436864 






268436864 


. bss 


2064 


268437264 






268437264 


Size of bug : 


16704 










Section 


Size 


Physical Address 


Virtual Addre 


. text 


12800 


4194672 






4194672 


. init 


32 


4207472 






4207472 


. rdata 


368 


268435456 






268435456 


. data 


16 


268435824 






268435824 


. sdata 


1024 


268435840 






268435840 


. sbss 


400 


268436864 






268436864 


. bss 


2064 


268437264 






268437264 


% Is -1 ! * 












Is -1 a.out 


bug 










-rwxr-xr-x 1 


bill 


3932 Dec 19 


09 


41 


a . out 


-rwxr-xr-x 1 


bill 


3932 Dec 19 


09 


42 


bug 


% bug 












hello 












% num bug . c 


| db 










db : Command 


not found . 









% ~db~cb 

cat bug . c | cb 

main( ) 

{ 

printf ("hello\n") / 

} 

% ! ! | lp 

cat bug . c | cb | lp 
% 



In this example we have a very simple C program which has a bug (or two) in it in the 
file 'bug.c', which we 'cat' out on our terminal. We then try to run the C compiler on 
it, referring to the file again as '!$', meaning the last argument to the previous com- 
mand. Here the T is the history mechanism invocation metacharacter, and the 
stands for the last argument, by analogy to in the editor which stands for the end 
of the line. The shell echoed the command, as it would have been typed without use 
of the history mechanism, and then executed it. 
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The compilation yielded error diagnostics so we now run the editor on the file we 
were trying to compile, fix the bug, and run the C compiler again this time referring 
to this command simply as '!c', which repeats the last command which started with 
the letter 'c'. If there were other commands starting with V done recently we could 
have said Mcc' or even '!cc:p' which would have printed the last command starting 
with 'cc' without executing it. 

After this recompilation, we ran the resulting 'a.out' file, and then noting that there 
still was a bug, ran the editor again. After fixing the program we ran the C compiler 
again, but tacked onto the command an extra '-o bug' telling the compiler to place 
the resultant binary in the file 'bug' rather than 'a.out'. In general, the history 
mechanisms may be used anywhere in the formation of new commands and other 
character may be placed before and after the substituted commands. 

We then ran the 'size' command to see how large the binary program images we have 
created were, and then an 'Is -1' command with the same argument list, denoting the 
argument list '*'. Finally we ran the program 'bug' to see that its output is indeed 
correct. 

To make a listing of the program we ran the cat command on the file 'bug.c'. To 
beautify the C-program, we took the output of 'num' and ran it through the filter 'cb', 
but misspelled it as spp. To correct this, we used a shell substitute, placing the old 
text and new text between <A? characters. This is similar to the substitute command in 
the editor. Finally, we repeated the same command with '!!', but sent its output to the 
line printer. 

There are other mechanisms available for repeating commands. The history com- 
mand prints out a number of previous commands with numbers by which they can be 
referenced. There is a way to refer to a previous command by searching for a string 
which appeared in it, and there are other, less useful, ways to select arguments to 
include in a new command. A complete description of all these mechanisms is given 
in the C shell manual pages in the User's Reference Manual. 



Aliases 

The shell has an alias mechanism which can be used to make transformations on 
input commands. This mechanism can be used to simplify the commands you type, to 
supply default arguments to commands, or to perform transformations on commands 
and their arguments. The alias facility is similar to a macro facility. Some of the 
features obtained by aliasing can be obtained also using shell command files, but these 
take place in another instance of the shell and cannot directly affect the current shells 
environment or involve commands such as cd which must be done in the current 
shell. 

As an example, suppose that there is a new version of the mail program on the sys- 
tem called 'newmaiP you wish to use, rather than the standard mail program which is 
called 'mail'. If you place the shell command 

alias mail newmail 



in your xshrc file, the shell transforms an input line of the form 
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mail bill 



into a call on 'newmail'. More generally, suppose we wish the command 'Is' to always 
show sizes of files, that is to always do < -s\ We can do 

alias Is Is -s 



or even 

alias dir Is -s 



creating a new command syntax 'dir' which does an 'Is -s\ If we say 
dir "bill 



then the shell translates this to 
Is -s /mnt/bill 



Thus the alias mechanism can be used to provide short names for commands, to pro- 
vide default arguments, and to define new short commands in terms of other com- 
mands. It is also possible to define aliases which contain multiple commands or pipe- 
lines, showing where the arguments to the original command are to be substituted 
using the facilities of the history mechanism. Thus the definition 

alias cd "cd \! * ; Is " 



would do an Is command after each change directory cd command. We enclosed the 
entire alias definition in ''' characters to prevent most substitutions from occurring 
and the character from being recognized as a metacharacter. The T here is 
escaped with a 'V to prevent it from being interpreted when the alias command is 
typed in. The '\!*' here substitutes the entire argument list to the pre-aliasing com- 
mand, without giving an error if there were no arguments. The ';' separating com- 
mands is used here to indicate that one command is to be done and then the next. 
Similarly the definition 

alias whois "grep \! ~ /etc/pas swd" 
defines a command which looks up its first argument in the password file. 
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VThe shell currently reads the xshrc file each time it starts up. If you place a large 
number of commands there, shells tends to start slowly, A mechanism for saving the 
shell environment after reading the .cshrc file and quickly restoring i under develop- 
ment, but for now you should try to limit the number of aliases you have to a reason- 
able number, 10 or 15 is reasonable, 50 or 60 causes a noticeable delay in starting up 
shells, and makes the system seem sluggish when you execute commands from within 
the editor and other programs, 



More Redirection: >> and >& 

There are a few more notations useful to the terminal user which have not been intro- 
duced yet. 

In addition to the standard output, commands also have a diagnostic output which is 
normally directed to the terminal even when the standard output is redirected to a file 
or a pipe, It is occasionally desirable to direct the diagnostic output along with the 
standard output. For instance if you want to redirect the output of a long running 
command into a file and wish to have a record of any error diagnostic it produces you 
can do 

command >& file 



The '>&' here tells the shell to route both the diagnostic output and the standard out- 
put into 'file*. Similarly you can give the command 

command | & lp 



to route both standard and diagnostic output through the pipe to the line printer pro- 
gram Ip, A command of the form 

command >&! file 



exists, and is used when noclobber is set and file already exists. 
Finally, it is possible to use the form 

command >> file 



to place output at the end of an existing file. If noclobber is set, then an error results 
if file does not exist, otherwise the shell creates file if it doesn't exist. A form 

command >>! file 



makes it not be an error for file to not exist when noclobber is set. 
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Background Processes 

When one or more commands are typed together as a pipeline or as a sequence of 
commands separated b semicolons, a single job is created by the shell consisting of 
these commands together as a unit. Single commands without pipes or semicolons 
create the simplest jobs. Usually, every line typed to the shell creates a job. Some 
lines that create jobs (one per line) are 

sort < data 

Is -s | sort -n | head -5 
mail harold 



If the metacharacter is typed at the end of the commands, then the job is started 
as a background job. This means that the shell does not wait for it to complete but 
immediately prompts and is ready for another command. The job runs in the back- 
ground at the same time that normal jobs, called foreground jobs, continue to be read 
and executed by the shell one at a time. Thus 

du > usage & 



would run the du program, which reports on the disk usage of your working directory 
(as we any directories below it), put the output into the file 'usage' and return immedi- 
ately with a prompt for the next command without out waiting for du to finish. The 
du program would continue executing in the background until it finished; you can type 
and execute more commands as du executes in the background. 

% du > usage & 

503 

% 



If the job doesn't terminate normally, a termination message appears: 

% du > usage & 
505 

% 505 : du : Terminated 



If you want the terminations of background jobs to be reported at the time they occur 
(possibly interrupting the output of other foreground jobs), you can set the notify vari- 
able. In the previous example this would mean that the message might have come 
right in the middle of the next command. Background jobs are unaffected by any sig- 
nals from the keyboard like the INTERRUPT, or QUIT signals mentioned earlier. 

When a job is started in the background using '&', its number, as well as the process 
numbers of all its (top level) commands, is typed by the s before prompting you for 
another command. For example, 
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% Is -s I sort -n > usage & 

2034 

2035 

% 



runs the 'Is' program with the '-s' options, pipes this output into the 'sort' program 
with the '-n' option which puts its output into the file 'usage'. Since the '&' was at the 
end of the line, these two programs were started together as a background job. After 
starting the job, the shell prints the process number of each program started in the 
job. Then the shell immediates prompts for a new command, leaving the job running 
simultaneously. 

The kill command terminates a background job immediately. It is given process 
numbers as arguments, as printed by Ips or Icsh Thus, in the example above, the run- 
ning du command could have been terminated by the command 

% kill 505 

% 5 05: du: Terminated 

The notify command (not the variable mentioned earlier) indicates that the termina- 
tion of a specific job should be reported at the time it finishes instead of waiting for 
the next prompt. 



Working Directories 

As noted earlier, the shell is always in a particular working directory. The 'change 
directory' command chdir (its short form cd may also be used) changes the working 
directory of the shell, that is, changes the directory you are located in. 

It is useful to make a directory for each project you wish to work on and to place all 
files related to that project in that directory. The 'make directory' command, mkdir, 
creates a new directory. The pwd ('print working directory') command reports the 
absolute pathname of the working directory of the shell, that is, the directory you are 
located in. Thus in the example below: 

% pwd 

/usr/bill 

% mkdir newpaper 

% chdir newpaper 

% pwd 

/usr/bill/newpaper 
% 

the user has created and moved to the directory newpaper. where, for example, he 
might place a group of related files. 
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No matter where you have moved to in a directory hierarchy, you can return to your 
'home' log-in directory by doing just 

cd 



with no arguments. The name '..' always means the directory above the current one in 
the hierarchy, thus 

cd . . 



changes the shell's working directory to the one directly above the current one. The 
name '..' can be used in any pathname, thus, 

cd . ./programs 

means change to the directory 'programs' contained in the directory above the current 
one. If you have several directories for different projects under, say, your home direc- 
tory, this shorthand notation permits you to switch easily between them. 

The shell always remembers the pathname of its current working directory the vari- 
able cwd. The shell can also be requested to remember the previous directory when 
you change to a new working directory. If the 'push directory' command pushd is 
used in place of the cd command, the shell saves the name of the current working 
directory on a directory stack before changing to the new one. You can see this list at 
any time by typing the 'directories' command dirs. 

% pushd newpaper/ref erences 
~/newpaper/ref erences 
% pushd /usr/lib/tmac 
/usr/lib/tmac "/newpaper/ref erences 
% dirs 

/usr/lib/tmac "/newpaper/ref erences 
% popd 

"/newpaper/ref erences 
% popd 

% 



The list is printed in a horizontal line, reading left to right, with a tilde (~) as short- 
hand for your home directory — in this case 7usr/bill\ The directory stack is printed 
whenever there is more than one entry on it and it changes. It is also printed by a dirs 
command. Dirs is usually faster and more informative than pwd since it shows the 
current working directory as well as any other directories remembered in the stack. 

The pushd command with no argument alternates the current directory with the first 
directory in the list. The 'pop directory' popd command without an argument returns 
you to your previous directory, discarding the previous current directory from the 
stack (forgetting it). Typing popd several times in a series takes you backward 
through the directories you had been in (changed to) by pushd command. There are 
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other options to pushd and popd to manipulate the contents of the directory stack 
and to change to directories not at the top of the stack; see the csh manual page for 
details. 



Useful Built-in Commands 

We now give a few of the useful built-in commands of the shell describing how they 
are used. 

The alias command described above is used to assign new aliases and to show the 
existing aliases. With no arguments it prints the current aliases. It may also be given 
only one argument such as 

alias Is 



to show the current alias for, e.g., 'Is'. 

The echo command prints its arguments. It is often used in shell scripts or as an 
interactive command to see what filename expansions produce. 

The history command shows the contents of the history list. The numbers given with 
the history events can be used to reference previous events which are difficult to refer- 
ence using the contextual mechanisms introduced above. There is also a shell variable 
called prompt. By placing a T character in its value, the shell substitutes the number 
of the current command in the history list. You can use this number to refer to this 
command in a history substitution Thus you could 

set prompt="\! % 



Note that the T character had to be escaped here even within *° characters. The 
logout command can be used to terminate a log-in shell which has ignoreeof set. 

The rehash command causes the shell to recompute a table of where commands are 
located. This is necessary if you add a command to a directory in the current shell's 
search path and wish the shell to find it, since otherwise the hashing algorithm may 
tell the shell that the command wasn't in that directory when the hash table was com- 
puted. The repeat command can be used to repeat a command several times. Thus to 
make 5 copies of the file one in the file five you could do 

repeat 5 cat one >> five 

The setenv command can be used to set variables in the environment. Thus 

setenv TERM adm3a 



sets the value of the environment variable TERM to 'adm3a\ A user program prin- 
tenv exists which prints out the environment. It might then show: 
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% printenv 

HOME=/usr/bill 

SHELL=/bin/csh 

PATH= : /usr/ucb : /bin : /usr/bin : /usr/local 

TERM=adm3a 

USER-bill 

% 



The source command can be used to force the current shell to read commands from 
a file. Thus 

source . cshrc 



can be used after editing in a change to the xshrc file which you wish to take effect 
right away. The time command can be used to cause a command to be timed no 
matter how much CPU time it takes. Thus 

% time cp /etc/rc /usr/bill/rc 
0,0u 0.1s 0:01 8% 2+lk 3+2io lpf+Ow 
% time wc /etc/rc /usr/bill/rc 

52 178 1347 /etc/rc 

52 178 1347 /usr/bill/rc 
104 356 2694 total 
O.lu 0. Is 0: 00 13% 3+3k 5+3io 7pf+0w 
% 



indicates that the cp command used a negligible amount of user time (u) and about 
l/10th of a system time (s); the elapsed time was 1 second (0:0 there was an average 
memory usage of 2k bytes of program space and Ik bytes of data space over the cpu 
time involved (2+lk); the program did three disk reads and two disk writes (3+2io), 
and took one page fault and was not swapped (lpf+Ow). The word count command wc 
on the other hand used 0.1 seconds of user time and 0.1 seconds of system time in 
less than a second of elapsed time. The percentage '13%' indicates that over the 
period when it was active the command 'wc' used an average of 13 percent of the 
available CPU cycles of the machine. 

The unalias and unset commands can be used to remove aliases and variable 
definitions from the shell, and unsetenv removes variables from the environment. 



What Else? 

This concludes the basic discussion of the shell for terminal users. There are more 
features of the shell to be discussed here, and all features of the shell are discussed in 
its manual pages. One useful feature which is discussed later is the foreach built-in 
command which can be used to run the same command sequence with a number of 
different arguments. 



9-24 USER'S GUIDE 



Terminal User Reference 



If you intend to use UMIPS frequently, you should look through the rest of this docu- 
ment and the csh manual pages in the User's Reference Manual to become familiar 
with the other facilities which are available to you. 
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Introduction 

It is possible to place commands in files and to cause shells to be invoked to read and 
execute commands from these files, which are called shell scripts. We here detail 
those features of the shell useful to the writers of such scripts, 



Make 

It is important to first note what shell scripts are not useful for. There is a program 
called make which is very useful for maintaining a group of related files or performing 
sets of operations on related files. For instance a large program consisting of one or 
more files can have its dependencies described in a makefile which contains 
definitions of the commands used to create these different files when changes occur. 
Definitions of the means for printing listings, cleaning up the directory in which the 
files reside, and installing the resultant programs are easily, and most appropriately 
placed in this makefile. This format is superior and preferable to maintaining a group 
of shell procedures to maintain these files; 

Similarly when working on a document a makefile may be created which defines how 
different versions of the document are to be created and which options of nroff or 
troff are appropriate. 



Invocation and the argv Variable 

A csh command script may be interpreted by saying 
% csh script ... 

where script is the name of the file containing a group of csh commands and 4 . . / is 
replaced by a sequence of arguments, The shell places these arguments in the variable 
argv and then begins to read commands from the script, These parameters are then 
available through the same mechanisms which are used to reference any other shell 
variables. If you make the file 'script ? executable by doing 

chmod 755 script 

and place a shell comment at the beginning of the shell script (i.e. begin the file with 
a character) then a 7bin/csh ? will automatically be invoked to execute 'script' 
when you type 

script 

If the file does not begin with a then the standard shell Vbin/sh' will be used to 
execute it. This allows you to convert your older shell scripts to use csh at your con- 
venience. 
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Variable Substitution 

After each input line is broken into words and history substitutions are done on it, 
the input line is parsed into distinct commands. Before each command is executed a 
mechanism know as variable substitution is done on these words. Keyed by the char- 
acter this substitution replaces the names of variables by their values, Thus 

echo $argv 

when placed in a command script would cause the current value of the variable argv 
to be echoed to the output of the shell script. It is an error for argv to be unset at this 
point. 

A number of notations are provided for accessing components and attribute of vari- 
ables. The notation 

$?name 

expands to T if name is set of to '0' if name is not set. It is the fundamental 
mechanism used for checking whether particular variables have been assigned values. 
All other forms of reference to undefined variables cause errors. 

The notation 

$#name 

expands to the number of elements in the variable name. Thus 

% set argv=(a be) 
% echo $?argv 
1 

% echo $#argv 
3 

% unset argv 
% echo $?argv 
0 

% echo $argv 

Undefined variable: argv. 
% 

It is also possible to access the components of a variable which has several values. 
Thus 

$argv[l] 

gives the first component of argv or in the example above V. Similarly 
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$argv[$#argv] 



would give V, and 
$argv[l-2] 

would give *a b ? . Other notations useful in shell scripts are 
$n 

where n is an integer as a shorthand for 

$<w:gv[n] 
the n th parameter and 

$* 

which is a shorthand for 

$argv 
The form 

$$ 

expands to the process number of the current shell. Since this process number is 
unique in the system it can be used in generation of unique temporary file names. The 
form 

$< 

is quite special and is replaced by the next line of input read from the shell's standard 
input (not the script it is reading). This is useful for writing shell scripts that are 
interactive, reading commands from the terminal, or even writing a shell script that 
acts as a filter, reading lines from its input file. Thus the sequence 

echo 'yes or no?\c' 
set a»($<) 

would write out the prompt 'yes or no?' without a newline and then read the answer 
into the variable *a\ In this case '$#a' would be *0' if either a blank line or end-of-file 
( A D) was typed. 
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One minor difference between '$n ? and 4 $argv[n] ? should be noted here. The form 
'$argv[n ]' will yield an error if n is not in the range 'l~$#argv' while '$n' will never 
yield an out of range subscript error. This is for compatibility with the way older 
shells handled parameters. 

Another important point is that it is never an error to give a subrange of the form 
'n-'; if there are less than n components of the given variable then no words are sub- 
stituted. A range of the form 'm-n' likewise returns an empty vector without giving an 
error when m exceeds the number of elements of the given variable provided the sub- 
script n is in range. 



Expressions 

In order for interesting shell scripts to be constructed it must be possible to evaluate 
expressions in the shell based on the values of variables. In fact, all the arithmetic 
operations of the language C are available in the shell with the same precedence that 
they have in C. In particular, the operations '==' and '!=' compare strings and the 
operators *&&' and *| |' implement the boolean and/or operation The special opera- 
tors s =~' and T' are similar to '==' and '!=' except that the string on the right side can 
have pattern matching characters (like *, ? or []) and the test is whether the string on 
the left matches the pattern on the right. 

The shell also allows file enquiries of the form 
-? filename. 

where is replace by a number of single characters. For instance the expression 
primitive 

-e filename 

tell whether the file 'filename' exists. Other primitives test for read, write and execute 
access to the file, whether it is a directory, or has non-zero length. 

It is possible to test whether a command terminates normally, by a primitive of the 
form '{ command }' which returns true, i.e. T if the command succeeds exiting nor- 
mally with exit status 0, or '0' if the command terminates abnormally or with exit 
status non-zero. If more detailed information about the execution status of a com- 
mand is required, it can be executed and the variable 'Sstatus' examined in the next 
command. Since '$status' is set by every command, it is very transient. It can be 
saved if it is inconvenient to use it only in the single immediately following command. 

For a full list of expression components available see the csh manual page in the 
User's Reference Manual. 

Sample Shell Script 

A sample shell script which makes use of the expression mechanism of the shell and 
some of its control structure follows: 
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% cat copyc 
# 

# Copyc copies those C programs in the specified list 

# to the directory "/backup if they differ from the files 

# already in "/backup 
# 

set noglob 

for each i ( $argv) 

if ($i ! ~ *.c) continue # not a . c file so do nothing 



if ( ! -r Vhackup/$i: t) then 
echo $i:t not in backup.., pot cpVed 
continue 

endif 

cmp -s $i Vbackup/$i:t # to set $status 



if ($status !~ 0) then 
echo new backup of $i 
cp $i "/hackup/$i:t 

endif 

end 



This script makes use of the foreach command, which causes the shell to execute the 
commands between the foreach and the matching end for each of the values given 
between '( ? and with the named variable, in this case T set to successive values in 
the list. Within this loop we may use the command break to stop executing the loop 
and continue to prematurely terminate one iteration and begin the next. After the 
foreach loop the iteration variable (i in this case) has the value at the last iteration. 

We set the variable noglob here to prevent filename expansion of the members of 
argv. This is a good idea, in general, if the arguments to a shell script are filenames 
which have already been expanded or if the arguments may contain filename expan- 
sion metacharacters. It is also possible to quote each use of a *$' variable expansion, 
but this is harder and less reliable. The other control construct used here is a state- 
ment of the form 



if (expression ) then 
command 



endif 



The placement of the keywords here is not flexible due to the current implementation 
of the shell. Notes The following two formats are not currently acceptable to the 
shell: 
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if ( expression )# Won't work! 
then 

command 

endif 

and 

if ( expression ) then command endif # Won't work 
The shell does have another form of the if statement of the form 

if ( expression ) command 
which can be written 

if ( expression ) 

command 

Here we have escaped the newline for the sake of appearance. The command must 
not involve 4 1 or and must not be another control command. The second 
form requires the final 4 V to immediately precede the end-of-line. 

The more general if statements above also admit a sequence of else -if pairs followeu 
by a single else and an endif, e.g.: 

if ( expression ) then 

commands 
else if (expression ) then 

commands 

else 

commands 

endif 

Another important mechanism used in shell scripts is the V modifier. We can use the 
modifier ':r' here to extract a root of a filename or *:e' to extract the extension. Thus 
if the variable i has the value Vmnt/foo.bar' then 

% echo $i $i:r $i:e 
/mnt/f oo . bar /mnt/foo bar 
% 

shows how the ':r' modifier strips off the trailing '.bar' and the the ':e' modifier leaves 
only the 'bar'. Other modifiers will take off the last component of a pathname leaving 
the head *:h' or all but the last component of a pathname leaving the tail ':t\ These 
modifiers are fully described in the csh manual pages in the f/^r'sReference It is also 
possible to use the command substitution mechanism described in the next major sec- 
tion to perform modifications on strings to then reenter the shell's environment. Since 
each usage of this mechanism involves the creation of a new process it is much more 
expensive to use than the V modification mechanism.$ 
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It is also important to note that the current implementation of the shell limits the 
number of V modifier on a substitution to 1. Thus 

% echo $i $i:h:t 
/a/b/c /a/b it 
% 

does not do what one would expect. 

Finally, we note that the character lexically introduces a shell comment in shell 
scripts (but not from the terminal). All subsequent characters on the input line after a 

are discarded by the shell. This character can be quoted using or 'V to place it 
in an argument word. 

Other Control Structures 

The shell also has control structures while and switch similar to those of C, These 
take the forms 

while ( expression ) 
commands 

end 

and 

switch ( word ) 
case strl: 

commands 
breaksw 



case strn: 

commands 
breaksw 

default : 

commands 
breaksw 

endsw 

For details see the csh manual page. C programmers should note that we use breaksw 
to exit from a switch while break exits a while or foreach loop. A common mistake to 
make in csh scripts is to use break rather than breaksw in switches. 

Finally, csh allows a goto statement, with labels looking like they do in C, i.e.: 
loop: 

commands 
goto lopp 
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Command Input 

Commands run from shell scripts receive by default the standard input of the shell 
which is running the script. This is different from previous shells running under 
UMIPS. It allows shell scripts to fully participate in pipelines, but mandates extra 
notation for commands which are to take inline data. 

Thus we need a metanotation for supplying inline data to commands in shell scripts. 
As an example, consider this script which runs the editor to delete leading blanks 
from the lines in each argument file: 

% cat deblank 

# deblank — remove leading blanks 

for each i ($argv) 

ed - $i << "EOF" 

l,$s/~[ ]*// 

w 

q 

"EOF" 

end 

% 

The notation '<< 'EOF'' means that the standard input for the ed command is to 
come from the text in the shell script file up to the next line consisting of exactly 
4 'EOF'\ The fact that the 'EOF' is enclosed in ''' characters, i.e. quoted, causes the 
shell to not perform variable substitution on the intervening lines. In general, if any 
part of the word following the '<<' which the shell uses to terminate the text to be 
given to the command is quoted then these substitutions will not be performed. In 
this case since we used the form %$' in our editor script we needed to insure that this 
'$' was not variable substituted. We could also have insured this by preceding the '$' 
here with a 'V, i.e.: 

l/\fs/ A [ ]*// 

but quoting the 'EOF' terminator is a more reliable way of achieving the same thing. 



Intercepting Interrupts 

If our shell script creates temporary files, we may wish to intercept interruptions of 
the shell script so that we can clean up these files. We can then do 

onintr label 

where label is a label in our program. If an interrupt is received the shell will do a 
'goto label' and we can remove the temporary files and then do an exit command 
(which is built in to the shell) to exit from the shell script. If we wish to exit with a 
non-zero status we can do 
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sxit(l) 



e.g. to exit with status T. 



Other Features 

There are other features of the shell useful to writers of shell procedures. The verbose 
and echo options and the related t- and command line options can be used to 
help trace the actions of the shell. The -n option causes the shell only to read com- 
mands and not to execute them and may sometimes be of use. 

One other thing to note is that csh will not execute shell scripts which do not begin 
with the character that is shell scripts that do not begin with a comment, Simi- 
larly, the Vbin/sh' on your system may well defer to 'csh' to interpret shell scripts 
which begin with '#'. This allows shell scripts for both shells to live in harmony It is 
advised that all csh scripts should have as the first line 

# !/bin/csh 

Appropriate options may be added to this line like: 
# !/bin/oah— -x 



There is also another quotation mechanism using " ,? which allows only some of the 
expansion mechanisms we have so far discussed to occur on the quoted string and 
serves to make this string into a single word as ^ does, 
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Loops at the Terminal; Variables as Vectors 

It is occasionally useful to use the foreach control structure at the terminal to aid in 
performing a number of similar commands. For instance, there were at one point 
three shells in use on the Cory UNIX system at Cory Hall, 7bin/sh', Vbin/nsh', and 
7bin/csh\ To count the number of persons using each shell one could have issued the 
commands 

% grep -c csh$ /etc/pas swd 
27 

% grep -c nsh$ /etc/pas swd 
128 

% grep -c -v sh$ /etc/pas swd . . 

430 

% 



Since these commands are very similar we can use foreach to do this more easily. 

% foreach i ("sh$" "csh$" "-v sh$") 

? grep -c $i /etc/pas swd 

? end 

27 

128 

430 

% 



Note here that the shell prompts for input with 4 ? * when reading the body of the 
loop. Variables that contain lists of filenames or other words can be very useful. For 
example: 

% set a=("ls") 

% echo $a 

csh.n csh.rin 

% Is 

csh . n 

csh.rm 

% echo $#a 

2 

% 



In this example, the set command gives the variable a a list of all the filenames in the 
current directory as value. We can then iterate over these names to perform any 
chosen function. 
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The output of a command within ^ characters is converted by the shell to a list of 
words. You can also place the <s? quoted string within characters to take each 
(non-empty) line as a component of the variable; preventing the lines from being split 
into words at blanks and tabs. A modifier ':x J exists which can be used later to 
expand each component of the variable into another variable splitting it into separate 
words at embedded blanks and tabs. 



Argument Expansion Braces { ... } 

Another form of filename expansion, alluded to before involves the characters and 
'}'. These characters specify that the contained strings, separated by V are to be con- 
secutively substituted into the containing characters and the results expanded left to 
right. Thus 

Afstrl, str2 , . . . strn}B 



expands to 

AstrlB Astr2B ... AstrnB 



This expansion occurs before the other filename expansions, and may be applied 
recursively (i.e. nested). The results of each expanded string are sorted separately, 
left to right order being preserved. The resulting filenames are not required to exist if 
no other expansion mechanisms are used. This means that this mechanism can be 
used to generate arguments which are not filenames, but which have common parts. 
A typical use of this would be 

mkdir ~/{hdrs t retrofit , csh} 



to make subdirectories 'hdrs', 'retrofit' and 'csh' in your home directory. This 
mechanism is most useful when the common prefix is longer than in this example, i.e. 

chown root /usr/{ucb/{ex, edit } ,lib/{ex?. ?*,how__ex} } 



Command Substitution 

A command enclosed in <v ' characters is replaced, just before filenames are expanded, 
by the output from that command. Thus it is possible to do 

set pwd=^pwcP 

to save the current directory in the variable pwd or to do 



9-36 USER'S GUIDE 



Miscellaneous Shell Features 



ex "grep -1 TRACE *.c" 



to run the editor ex supplying as arguments those files whose names end in c .c' which 
have the string TRACE' in them. 



NOTE 



Command expansion also occurs in input redirected with '<<' and within quota- 
tions. Refer to the csh(l) manual page in the User's Reference Manual for details. 



Other Shell References 

In particular circumstances it may be necessary to know the exact nature and order of 
different substitutions performed by the shell. The exact meaning of certain combina- 
tions of quotations is also occasionally important. These are detailed fully in the 
csh(l) manual page. 

The shell has a number of command line option flags mostly of use in writing UMIPS 
programs, and debugging shell scripts. See the csh(l) manual page for a list of 
options available. 
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The following table lists the special characters of csh and the UNIX system, giving for 
each the section(s) in which is discussed. A number of these characters also have 
special meaning in expressions. See the csh manual section for a complete list. 

Syntactic metacharacters 



; separates commands to be executed sequentially 

| separates commands in a pipeline 

() brackets expressions and variable values 

& follows commands to be executed without waiting for completion 



Filename metacharacters 

/ separates components of a file's pathname 

? expansion character matching any single character 

* expansion character matching any sequence of characters 

[] expansion sequence matching any single character from a set 

used at the beginning of a filename to indicate home directories 
} used to specify groups of arguments with common parts 



Input/Output metacharacters 



< indicates redirected input 
> indicates redirected output 



Expansion/substitution metacharacters 

$ indicates variable substitution 

! indicates history substitution 

: precedes substitution modifiers 

* used in special forms of history substitution 

' indicates command substitution 



Other Metacharacters 

# indicates shell comments 

- prefixes otion (flag) agrguments to commands 
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This glossary lists the most important terms introduced in the introduction to the shell 
and gives references to sections of the this chapter for further information about 
them. References of the form pr(l) indicate that the command pr is in Section 1 of 
the User's Reference Manual. You can look at an online copy of its manual page by 
entering man 1 pr. 

Your current directory has the name '.' as well as the name 
printed by the command pwd; see also dirs. The current 
directory V is usually the first component of the search path 
contained in the variable path, thus commands which are in '.' 
are found first (see 'Shell Variables'). The character '/is also 
used in separating components of filenames (see 'Filenames'), 
The character '.' at the beginning of a component of a path- 
name is treated specially and not matched by the metacharac- 
ters '?', '*', and '[' ']' pairs (see 'Filenames'). 

Each directory has a file '..' in it which is a reference to its 
parent directory. After changing into the directory with chdir, 
i.e. 

chdir paper 
you can return to the parent directory by doing 
chdir . . 

The current directory is printed by pwd (see 'Working Direc- 
tories'). 

a. out Compilers which create executable images create them, by 

default, in the file a.out for historical reasons (see 'History 
List'). 

absolute pathname A pathname which begins with a 7' is absolute since it 

specifies the path of directories from the beginning of the 
entire directory system - called the root directory. Pathnames 
which are not absolute are called relative (see definition of 
relative pathname) (see 'Filenames'). 

alias An alias specifies a shorter or different name for a UMIPS 

command, or a transformation on a command to be per- 
formed in the shell. The shell has a command alias which 
establishes aliases and can print their current values. The 
command unalias is used to remove aliases (see 'Aliases'). 

argument Commands in UMIPS receive a list of argument words. Thus 

the command 

echo a b c 

consists of the 'echo' and three argument words 'a', 'b' and 
'c'. The set of arguments after the is said to be the of the com- 
mand (see 'Using the Shell Interactively'). 

argv The list of arguments to a command written in the shell 

language (a shell script or shell procedure) is stored in a vari- 
able called argv within the shell. This name is taken from the 
conventional name in the C programming language (see 
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background 
base 

bin 



break 
breaksw 

builtin 



case 

cat 

cd 

chdir 
cmp 

command 



'Variable Substitution'). 

Commands started without waiting for them to complete are 
called background commands (see 'Background Processes'). 

A filename is sometimes thought of as consisting of a base 
part, before any '.' character, and an extension - the part after 
the V. See filename and extension (see 'Filenames') and 
basename(l). 

A directory containing binaries of programs and, shell scripts 
to be executed is typically called a bin directory. The standard 
system bin directories are '/bin' containing the most heavily 
used commands and '/usr/bin' which contains most other user 
programs, Programs developed at UC Berkeley live in 
'/usr/ucb', while locally written programs live in 
'/usr/local/bin'. Games are kept in the directory 7usr/games\ 
You can place binaries in any directory. If you wish to execute 
them often, the name of the directories should be a com- 
ponent of the variable path. 

Break is a builtin command used to exit from loops within the 
control structure of the shell (see 'Other Control Structures'). 

The breaksw builtin command is used to exit from a switch 
control structure, like a break exits from loops (see 'Other 
Control Structures'), 

A command executed directly by the shell is called a builtin 
command. Most commands in UMIPS are not built into the 
shell, but rather exist as files in bin directories. These com- 
mands are accessible because the directories in which they 
reside are named in the path variable. 

A case command is used as a label in a switch statement in the 
shell's control structure, similar to that of the language C. 
Details are given in the section "Other Control Structures" in 
this chapter and in the csh(l) manual page. 

The cat program catenates a list of specified files on the It is 
usually used to look at the contents of a single file on the ter- 
minal to 'cat a file' (see 'Terminating Commands', 'History 
list'). 

The cd command is used to change the With no arguments, cd 
changes your to be your home directory (see 'Aliases', 'Work- 
ing Directories'). 

The chdir command is a synonym for cd. Cd is usually used 
because it is easier to type, 

Cmp is a program which compares files. It is usually used on 
binary files, or to see if two files are identical. For comparing 
text files the program diff, described in diff(l), is used. 

A function performed by the system, either by the shell (a 
builtin command) or by a program residing in a file in a direc- 
tory within the UMIPS system, is called a command (see 
'Using the Shell Interactively'). 
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command name When a command is issued, it consists of a command name, 

which is the first word of the command, followed by argu- 
ments. The convention on UMIPS is that the first word of a 
command names the function to be performed (see 'Using the 
Shell Interactively'). 

command substitution 

The replacement of a command enclosed in ' v ' characters by 
the text output by that command is called command substitu- 
tion. 

component A part of a pathname between 7' characters is called a com- 

ponent of that pathname. A variable which has multiple 
strings as value is said to have several components; each string 
is a component of the variable. 

continue A builtin command which causes execution of the enclosing 

foreach or while loop to cycle prematurely. Similar to the con- 
tinue command in the programming language G (see 'Sample 
Shell Script'). 

Certain special characters, called control characters, are pro- 
duced by holding down the CONTROL key on your terminal 
and simultaneously pressing another character, much like the 
SHIFT key is used to produce upper case characters. Thus 
control-c is produced by holding down the CONTROL key 
while pressing the 'c' key. Usually UMIPS prints an caret ( A ) 
followed by the corresponding letter when you type a control 
character (e.g. ' A C for control- c). 

When a program terminates abnormally, the system places an 
image of its current state in a file named 'core'. This can be 
examined with the system debugger dbx in order to determine 
what went wrong with the program (see 'Terminating Com- 
mands'). If the shell produces a message of the form 

Illegal instruction (core dumped) 



(where 'Illegal instruction' is only one of several possible mes- 
sages), you should report this to the author of the program or 
a system administrator, saving the 'core' file. 

The cp (copy) program is used to copy the contents of one file 
into another file. It is one of the most commonly used UMIPS 
commands (see 'Filenames'). 

The name of the shell program that this document describes. 

The file xshrc in your home directory is read by each shell as 
it begins execution. It is usually used to change the setting of 
the variable path and to set alias parameters which are to take 
effect globally (see 'Startup and Termination'). 

The cwd variable in the shell holds the absolute pathname of 
the current It is changed by the shell whenever your current 
working directory changes and should not be changed other- 
wise (see 'Shell Variables'). 



control- 



core dump 



cp 

csh 
.cshrc 

cwd 
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debugging 
default: 

DELETE 

detached 
diagnostic 



directory 



directory stack 

dirs 
du 

echo 

else 

endif 



The date command prints the current date and time (see 'Out- 
put to Files'). 

debugging is the process of correcting mistakes in programs 
and shell scripts. The shell has several options and variables 
which may be used to aid in shell debugging. 

The label default: is used within shell switch statements, as it 
is in the C language to label the code to be executed if none of 
the case labels matches the value switched on (see 'Other 
Control Structures'). 

The DELETE or RUBOUT key on the terminal normally 
causes an interrupt to be sent to the current Many users 
change the interrupt character to be A C. 

A command that continues running in the background after 
you logout is said to be detached. 

An error message produced by a program is often referred to 
as a diagnostic. Most error messages are not written to the 
since that is often directed away from the terminal (see 'Outut 
to Files', see 'Input from Files: Pipelines'). Error messages are 
instead written to the which may be directed away from the 
terminal, but usually is not. Thus diagnostics usually appears 
on the terminal (see 'More Redirection'). 

A structure which contains files. At any time you are in one 
particular directory whose names can be printed by the com- 
mand pwd. The chdir command changes you to another 
directory, and make the files in that directory visible. The 
directory in which you are when you first login is your home 
directory (see 'Using the Shell Interactively', 'Working Direc- 
tories'). 

The shell saves the names of previous in the when you change 
your current via the pushd command. The can be printed by 
using the dirs command, which includes your current as the 
first directory name on the left (see 'Working Directories'). 

The dirs command prints the shell's directory stack (see 
'Working Directories'). 

The du command is a program (described in du(l)) which 
prints the number of disk blocks is all directories below and 
including your current working directory (see 'Background 
Processes'). 

The echo command prints its arguments (see 'Filenames', 
'Sample Shell Script'). 

The else command is part of the 'if-then-else-endif control 
command construct (see 'Sample Shell Script'). 

If an if statement is ended with the word then, all lines follow- 
ing the if up to a line starting with the word endif or else are 
executed if the condition between parentheses after the if is 
true (see 'Sample Shell Script'). 
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EOF 



escape 



/etc/passwd 



exit 



exit status 



expansion 



An end-of-file is generated by the terminal by a control-d, and 
whenever a command reads to the end of a file which it has 
been given as input. Commands receiving input from a pipe 
receive an end-of-file when the command sending them input 
completes. Most commands terminate when they receive an 
end-of-file. The shell has an option to ignore end-of-file from 
a terminal input which may help you keep from logging out 
accidentally by typing too many control-d' s (see 'Using the 
Shell Interactively', 'Terminating Commands', 'Command 
Input'). 

A character 'V used to prevent the special meaning of a meta- 
character is said to escape the character from its special mean- 
ing. Thus 

echo \* 

echos the character '*' while just 

echo * 

echos the names of the file in the current directory. In this 
example, \escapes '*' (see 'Quotations'). There is also a non- 
printing character called escape, usually labelled ESC or. ALT- 
MODE on terminal keyboards. Some older UNIX systems use 
this character to indicate that output is to be suspended. Most 
systems use control-s to stop the output and control-q to start 
it. 

This file contains information about the accounts currently on 
the system. It consists of a line for each account with fields 
separated by V characters (see 'Terminating Commands'). 
You can look at this file by saying 

cat /etc/passwd 

The commands finger and grep are often used to search for 
information in this file. See finger(l), passwd(4) and grep(l) 
manual pages for details. 

The exit command is used to force termination of a shell 
script, and is built into the shell (see 'Intercepting Interrupts'). 

A command which discovers a problem may reflect this back 
to the command (such as a shell) which invoked (executed) it. 
It does this by returning a non-zero number as its exit status, a 
status of zero being considered 'normal termination'. The exit 
command can be used to force a shell command script to give 
a non-zero exit status (see 'Sample Shell Script'). 

The replacement of strings in the shell input which contain 
metacharacter by other strings is referred to as the process of 
expansion. Thus the replacement of the word '*' by a sorted 
list of files in the current directory is a 'filename expansion'. 
Similarly the replacement of the characters '!!' by the text of 
the last command is a 'history expansion'. Expansions are also 
referred to as substitutions (see 'Filenames' and 'Variable Sub- 
stitution'). 
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Expressions are used in the shell to control the conditional 
structures used in the writing of shell scripts and in calculating 
values for these scripts. The operators available in shell 
expressions are those of the language C (see 'Expressions'). 

Filenames often consist of a base name and an extension 
separated by the character V. By convention, groups of 
related files often share the same root name. Thus if 'prog.c' 
were a C program, then the object file for this program would 
be stored in 'prog.o'. Similarly a paper written with the '-me' 
nroff macro package might be stored in 'paper. me' while a for- 
matted version of this paper might be kept in 'paper.out' and 
a list of spelling errors in 'paper. errs' (see 'Filenames'). 

The job control command fg is used to run a background or 
suspended job in the foreground (see 'Terminating Com- 
mands', 'Background Processes'), 

Each file in UMIPS has a name consisting of up to 14 charac- 
ters and not including the character V which is used in path- 
name building. Most filenames do not begin with the charac- 
ter '.', and contain only letters and digits with perhaps a '.' 
separating the base portion of the filename from an extension 
(see 'Filenames'). 

Filename expansion uses the metacharacters '*', '?' and '[' and 
']' to provide a convenient mechanism for naming files. Using 
filename expansion it is easy to name all the files in the current 
directory, or all files which have a common root name. Other 
filename expansion mechanisms use the metacharacter '~' and 
allow files in other users' directories to be named easily (see 
'Filenames'). 

Many UMIPS commands accept arguments which are not the 
names of files or other users but are used to modify the action 
of the commands These are referred to as flag options, and by 
convention consist of one or more letters preceded by the 
character '-' (see 'Flag Arguments'). Thus the Is (list files) 
command has an option '~s' to list the sizes of files. This is 
specified 

Is -s 



foreach 

goto 
grep 



The foreach command is used in shell scripts and at the termi- 
nal to specify repetition of a sequence of commands while the 
value of a certain shell variable ranges through a specified list 
(see 'Sample Shell Script'). 

The shell has a command goto used in shell scripts to transfer 
control to a given label (see 'Other Control Structures'). 

The grep command searches through a list of argument files 
for a specified string. Thus 

grep bill /etc/passed 

prints each line in the file /etc/passwd which contains the 
string 'bill'. Actually, grep scans for regular expressions in the 
sense of the editors ed(l) and ex(l). Grep stands for 'globally 
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find regular expression and print' (see Aliases'). 

The history mechanism of the shell allows previous commands 
to be repeated, possibly after modification to correct typing 
mistakes or to change the meaning of the command. The shell 
has a history list where these commands are kept, and a his- 
tory variable which controls how large this list is (see 'History 
List'). 

Each user has a home directory, which is given in your entry in 
the password file, /etc/passwd. This is the directory which you 
are placed in when you first login. The cd or chdir command 
with no arguments takes you back to this directory, whose 
name is recorded in the shell variable home. You can also 
access the home directories of other users in forming filenames 
using a filename expansion notation and the character '~' (see 
'Filenames'). 

A conditional command within the shell, the if command is 
used in shell command scripts to make decisions about what 
course of action to take next (see 'Sample Shell Script'). 

Normally, your shell exits, printing 'logout' if you type a 
control-d. at a prompt of '%'. This is the way you usually log 
off the system. You can set the ignoreeof variable if you wish 
in your .login file and then use the command logout to logout. 
This is useful if you sometimes accidentally type too many 
control-d characters, logging yourself off (see 'Shell Vari- 
ables'). 

Many commands on UMIPS take information from the termi- 
nal or from files which they then act on. This information is 
called input. Commands normally read for input from their 
standard input which is, by default, the terminal. This stan- 
dard input can be redirected from a file using a shell metano- 
tation with the character '<'. Many commands also read from 
a file specified as argument. Commands placed in pipelines 
read from the output of the previous command in the pipeline. 
The leftmost command in a pipeline reads from the terminal if 
you neither redirect its input nor give it a filename to use as 
standard input. Special mechanisms exist for supplying input 
to commands in shell scripts (see 'Input from Files: Pipelines', 
'Command Input'). 

An interrupt is a signal to a program that is generated by typ- 
ing A C. (On older versions of UNIX, the RUBOUT or 
DELETE key were used for this purpose.) It causes most pro- 
grams to stop execution. Certain programs, such as the shell 
and the editors, handle an interrupt in special ways, usually by 
stopping what they are doing and prompting for another com- 
mand. While the shell is executing another command and wait- 
ing for it to finish, the shell does not listen to interrupts. The 
shell often wakes up when you hit interrupt because many 
commands die when they receive an interrupt (see 'Terminat- 
ing Commands', 'Intercepting Interrupts'). 
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A command which sends a signal to a process causing it to 
terminate (see 'Background Processes'). 

The program less writes a file on your terminal allowing you to 
control how much text is displayed at a time. Less can move 
through the file screenful by screenful, line by line, search for- 
ward for a string, or start again at the beginning of the file. It 
is generally the easiest way of viewing a file (see 'Terminating 
Commands'). 

The file .login in your home directory is read by the shell each 
time you login to UMIPS and the commands there are exe- 
cuted. There are a number of commands which are usefully 
placed here, especially set commands to the shell itself (see 
'Startup and Termination'). 

The shell that is started on your terminal when you login is 
called your login shell. It is different from other shells which 
you may run (e.g. on shell scripts) in that it reads the .login 
file before reading commands from the terminal and it reads 
the .logout file after you logout (see 'Startup and Termina- 
tion'). 

The logout command causes a login shell to exit. Normally, a 
login shell exits when you hit control-d generating an end-of- 
file, but if you have set ignoreeof in your .login file then this 
doesn't work and you must use logout to log off the UMIPS 
system (see 'Useful Built-in Commands'). 

When you log off, the shell executes commands from the file 
.logout in your home directory after it prints 'logout'. 

The command lp is the line printer daemon. The standard 
input of lp spooled and printed on the UMIPS line printer. 
You can also give lp a list of filenames as arguments to be 
printed, lp is often used as the last component of a pipeline 
(see 'History List'). 

The Is (list files) command is one of the most commonly used 
UMIPS commands. With no argument filenames it prints the 
names of the files in the current directory. It has a number of 
useful flag arguments, and can also be given the names of 
directories as arguments, in which case it lists the names of 
the files in these directories (see 'Flag Arguments'). 

The mail program is used to send and receive messages from 
other UMIPS users (see 'Using the Shell Interactively', 
'Startup and Termination'), whether they are logged on or not. 

The make command is used to maintain one or more related 
files and to organize functions to be performed on these files. 
In many ways make is easier to use, and more helpful than 
shell command scripts (see 'Make'). 

The file containing commands for make is called makefile or 
Makefile (see 'Make'). 
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MIPS Computer Systems provides a set of manuals often 
referred to throughout the documentation. The UMIPS sys- 
tem documentation is divided into guide and reference manu- 
als. The primary reference manuals are the following: 

User's Reference Manual 
Programmer's Reference Manual 
System Administrator's Reference Manual 

These manuals contain eight numbered sections with a 
description of each UNIX program (section 1), system call 
(section 2), subroutine (section 3), file formats (section 4), 
miscellaneous facilities (section 5), system maintenance pro- 
grams (section 1M), and special system administrative files 
(section 7). An online version of the commands in each of 
the reference manuals is accessible through the man com- 
mand. For example, 

man cc 

displays the manual page that gives information on the UMIPS 
C language compiler. You should request a price list from 
your MIPS Computer Systems sales representative for a com- 
plete list of the documents available. 

Many characters which are neither letters nor digits have spe- 
cial meaning either to the shell or to UMIPS. These charac- 
ters are called metacharacters. If it is necessary to place these 
characters in arguments to commands without them having 
their special meaning then they must be quoted. An example 
of a metacharacter is the character '>' which is used to indi- 
cate placement of output into a file. For the purposes of the 
history mechanism, most unquoted metacharacters form 
separate words (see 'Metacharacters in the Shell'). The appen- 
dix to this user's manual lists the metacharacters in groups by 
their function. 

The mkdir command is used to create a new directory. 

Substitutions with the history mechanism, keyed by the char- 
acter '!' or of variables using the metacharacter '$', are often 
subjected to modifications, indicated by placing the character 
':' after the substitution and following this with the modifier 
itself. The command substitution mechanism can also be used 
to perform modification in a similar way, but this notation is 
less clear (see 'Sample Shell Script'). 

An ancestor of the less command. 

The shell has a variable noclobber which may be set in the file 
.login to prevent accidental destruction of files by the '>' out- 
put redirection metasyntax of the shell (see 'Shell Variables', 
'More Redirection'). 

The shell variable noglob is set to suppress the filename 
expansion of arguments containing the metacharacters '~', '*', 
'?', '[' and ']'. 
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The notify command tells the shell to report on the termina- 
tion of a specific background job at the exact time it occurs as 
opposed to waiting until just before the next prompt to report 
the termination. The notify variable, if set, causes the shell to 
always report the termination of background jobs exactly when 
they occur (see 'Background Processes'). 

The onintr command is built into the shell and is used to con- 
trol the action of a shell command script when an interrupt sig- 
nal is received (see 'Intercepting Interrupts'). 

Many commands in UMIPS result in some lines of text which 
are called their output. This output is usually placed on what 
is known as the standard output which is normally connected 
to the user's terminal. The shell has a syntax using the meta- 
character '>' for redirecting the standard output of a com- 
mand to a file (see 'Outut to Files'). Using the pipe mechanism 
and the metacharacter '|' it is also possible for the standard 
output of one command to become the standard input of 
another command (see 'Input from Files: Pipelines'). Certain 
commands such as the line printer daemon p do not place 
their results on the standard output but rather in more useful 
places such as on the line printer (see 'History List'). Similarly 
the write command places its output on another user's termi- 
nal rather than its standard output (see 'History List'). Com- 
mands also have a diagnostic output where they write their 
error messages. Normally these go to the terminal even if the 
standard output has been sent to a file or another command, 
but it is possible to direct error diagnostics along with stan- 
dard output using a special metanotation (see 'More Redirec- 
tion'). 

The shell has a variable path which gives the names of the 
directories in which it searches for the commands which it is 
given. It always checks first to see if the command it is given 
is built into the shell. If it is, then it need not search for the 
command as it can do it internally. If the command is not 
builtin, then the shell searches for a file with the name given 
in each of the directories in the path variable, left to right. 
Since the normal definition of the path variable is something 
like 

path (/usr/ucb /bin /usr/bin) 

the shell normally looks in the standard system directories 
'/usr/ucb', '/bin' and '/usr/bin' and then in the current direc- 
tory for the command (see 'Shell Variables'). If the command 
cannot be found the shell prints an error diagnostic. Scripts of 
shell commands are executed using another shell to interpret 
them if they have 'execute' permission set. This is normally 
true because a command of the form 

chmod 755 script 

was executed to turn this execute permission on (see 'Invoca- 
tion and the argv Variable'). If you add new commands to a 
directory in the path, you should issue the command rehash 
(see 'Shell Variables'). 
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A list of names, separated by 7' characters, forms a path- 
name. Each component, between successive 7' characters, 
names a directory in which the next component file resides. 
Pathnames which begin with the character 7' are interpreted 
relative to the root directory in the file system. Other path- 
names are interpreted relative to the current directory as 
reported by pwd. The last component of a pathname may 
name a directory, but usually names a file. 

A group of commands which are connected together, the stan- 
dard output of each connected to the standard input of the 
next, is called a pipeline. The pipe mechanism used to con- 
nect these commands is indicated by the shell metacharacter 
'|' (see Input from Files: Pipelines', 'History List'). 

The popd command changes the shell's working directory to 
the directory you most recently left using the pushd command. 
It returns to the directory without having to type its name, for- 
getting the name of the current working directory before doing 
so (see 'Working Directories'). 

The part of a computer system to which each terminal is con- 
nected is called a port. Usually the system has a fixed number 
of ports, some of which are connected to telephone lines for 
dial-up access, and some of which are. permanently wired 
directly to specific terminals. 

The pr command is used to prepare listings of the contents of 
files with headers giving the name of the file and the date and 
time at which the file was last modified (see 'History List'). 

The printenv command is used to print the current setting of 
variables in the environment (see 'Useful Built-in Com- 
mands'). 

An instance of a running program is called a process (see 
'Background Processes'). UMIPS assigns each process a 
unique number when it is started - called the process number. 
Process numbers can be used to stop individual processes using 
the kill command when the processes are part of a detached 
background job. 

Usually synonymous with command) a binary file or shell com- 
mand script which performs a useful function is often called a 
program. 

Many programs print a prompt on the terminal when they 
expect input. Thus the editor ex(l) prints a ':' when it expects 
input. The shell prompts for input with '%' and occasionally 
with '?' when reading commands from the terminal (see 'Using 
the Shell Interactively'). The shell has a variable prompt which 
may be set to a different value to change the shell's main 
prompt. This is mostly used when debugging the shell (see 
'Useful Built-in Commands'). 

The pushd command, which means 'push directory', changes 
the shell's working directory and also remembers the current 
working directory before the change is made, allowing you to 
return to the same directory via the popd command later 
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without retyping its name (see Working Directories'). 

The ps command is used to show the processes you are 
currently running. Each process is shown with its unique pro- 
cess number, an indication of the terminal name it is attached 
to, an indication of the state of the process (whether it is run- 
ning, stopped, awaiting some event (sleeping), and whether it 
is swapped out), and the amount of CPU time it has used so 
far. The command is identified by printing some of the words 
used when it was invoked (see background Processes'). 
Shells, such as the csh you use to run the ps command, are 
not normally shown in the output. 

The pwd command prints the full pathname of the current 
working directory. The dirs builtin command is usually a 
better and faster choice. 

The quit signal, generated by a controlA, is used to terminate 
programs which are behaving unreasonably. It normally pro- 
duces a core image file (see 'Terminating Commands'). 

The process by which metacharacters are prevented their spe- 
cial meaning, usually by using the character ''' in pairs, or by 
using the character 'V, is referred to as quotation (see 'Quota- 
tions'). 

The routing of input or output from or to a file is known as 
redirection of input or output (see 'Outut to Files'). 

The rehash command tells the shell to rebuild its internal 
table of which commands are found in which directories in 
your path. This is necessary when a new program is installed 
in one of these directories (see 'Useful Built-in Commands'). 

A pathname which does not begin with a 7' is called a relative 
pathname since it is interpreted relative to the current working 
directory. The first component of such a pathname refers to 
some file or directory in the working directory, and subsequent 
components between 7' characters refer to directories below 
the working directory. Pathnames that are not relative are 
called absolute pathnames (see 'Filenames'). 

The repeat command iterates another command a specified 
number of times. 

The directory that is at the top of the entire directory structure 
is called the root directory since it is the 'root' of the entire 
tree structure of directories. The name used in pathnames to 
indicate the root is 7'. Pathnames starting with 7' are said to 
be absolute since they start at the root directory. Root is also 
used as the part of a pathname that is left after removing the 
extension. See filename for a further explanation (see 
'Filenames'). 

The RUBOUT or DELETE key is often used to erase the pre- 
viously typed character; some users prefer the BACKSPACE 
for this purpose. On older versions of UNIX this key served 
as the INTR character. DEL is the default INTR character 
for UMIPS. 



9-50 USER'S GUIDE 



Glossary 



script 



set 



setenv 



shell 



shell script 
signal 



sort 



source 



special character 
standard 



status 



string 



stty 



Sequences of shell commands placed in a file are called shell 
command scripts. It is often possible to perform simple tasks 
using these scripts without writing a program in a language 
such as C, by using the shell to selectively run other programs 
(see 'Invocation and the argv Variable', 'Other Features'). 

The builtin set command is used to assign new values to shell 
variables and to show the values of the current variables. 
Many shell variables have special meaning to the shell itself. 
Thus by using the set command the behavior of the shell can 
be affected (see 'Startup and Termination'). 

Variables in the environment environ(5) can be changed by 
using the setenv builtin command (see 'Useful Built-in Com- 
mands'). The printenv command can be used to print the 
value of the variables in the environment 

A shell is a command language interpreter. It is possible to 
write and run your own shell, as shells are no different than 
any other programs as far as the system is concerned. This 
chapter deals with the details of one particular shell, called 
csh. 

See script (see 'Invocation and the argv Variable', 'Other 
Features'). 

A signal in UMIPS is a short message that is sent to a running 
program which causes something to happen to that process. . 
Signals are sent either by typing special control characters on 
the keyboard or by using the kill command (see 'Terminating 
Commands', 'Background Processes'). 

The sort program sorts a sequence of lines in ways that can be 
controlled by argument flags (see 'Input from Files: Pipe- 
lines'). 

The source command causes the shell to read commands from 
a specified file. It is most useful for reading files such as 
♦cshrc after changing them (see 'Useful Built-in Commands'). 

See metacharacters and 'Special Characters'. 

We refer often to the standard input and standard output of 
commands. See input and output (see 'Outut to Files', 'Com- 
mand Input'). 

A command normally returns a status when it finishes. By 
convention a status of zero indicates that the command suc- 
ceeded. Commands may return non-zero status to indicate that 
some abnormal event has occurred. The shell variable status is 
set to the status returned by the last command. It is most use- 
ful in shell command scripts (see 'Sample Shell Script'). 

A sequential group of characters taken together is called a 
string. Strings can contain any printable characters (see 'Shell 
Variables'). 

The stty program changes certain parameters inside UMIPS 
which determine how your terminal is handled. See stty(l) for 
a complete description. 
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The shell implements a number of substitutions where 
sequences indicated by metacharacters are replaced by other 
sequences Notable examples of this are history substitution 
keyed by the metacharacter T and variable substitution indi- 
cated by '$'. We also refer to substitutions as expansions (see 
'Variable Substitution'), 

The switch command of the shell allows the shell to select one 
of a number of sequences of commands based on an argument 
string. It is similar to the switch statement in the language C 
(see 'Other Control Structures'). 

When a command which is being executed finishes we say it 
undergoes termination or terminates. Commands normally ter- 
minate when they read an end-of-file from their standard 
input. It is also possible to terminate commands by sending 
them an interrupt or quit signal (see Terminating Com- 
mands'). The kill program terminates specified jobs (see 
'Background Processes'). 

The then command is part of the shell's 'if-then-else-endif 
control construct used in command scripts (see 'Sample Shell 
Script'). 

The time command can be used to measure the amount of 
CPU and real time consumed by a specified command as well 
as the amount of disk i/o, memory utilized, and number of 
page faults and swaps taken by the command (see 'Startup and 
Termination', 'Useful Built-in Commands'). 

The word tty is a historical abbreviation for 'teletype' which is 
frequently used in UMIPS to indicate the port to which a given 
terminal is connected, The tty command prints the name of 
the tty or port to which your terminal is presently connected. 

The unalias command removes aliases (see 'Useful Built-in 
Commands') . 

UNIX is an operating system on which csh runs. UNIX pro- 
vides facilities which allow csh to invoke other programs such 
as editors and text formatters which you may wish to use. 

The unset command removes the definitions of shell variables 
(see 'Shell Variables', 'Useful Built-in Commands'). 

See variables and expansion (see 'Shell Variables', 'Variable 
Substitution'). 

Variables in csh hold one or more strings as value. The most 
common use of variables is in controlling the behavior of the 
shell. See path, noclobber, and ignoreeof for examples. Vari- 
ables such as argv are also used in writing shell programs 
(shell command scripts) (see * Shell Variables'). 

The verbose shell variable can be set to cause commands to be 
echoed after they are history expanded. This is often useful in 
debugging shell scripts. The verbose variable is set by the 
shell's -v command line option (see 'Other Features'). 
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The c program calculates the number of characters, words, 
and lines in the files whose names are given as arguments (see 
'Background Processes'). 

The while builtin control construct is used in shell command 
scripts (see 'Other Control Structures'). 

A sequence of characters which forms an argument to a com- 
mand is called a word. Many characters which are neither 
letters, digits, '-', V nor 7' form words all by themselves even 
if they are not surrounded by blanks. Any sequence of charac- 
ters may be made into a word by surrounding it with <0 charac- 
ters except for the characters ''' and T which require special 
treatment (see 'Using the Shell Interactively'). This process of 
placing special characters in words without their special mean- 
ing is called quoting. 

At any given time you are in one particular directory, called 
your working directory. This directory's name is printed by 
the pwd command and the files listed by Is are the ones in this 
directory. You can change working directories using chdir. 

The write command is an obsolete way of communicating with 
other users who are logged on (you have to take turns typing). 
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The UMIPS System Files 



This appendix summarizes the description of the file system given in Chapter 1 and 
reviews the major system directories in the root directory. 



The UMIPS System files are organized in a hierarchy; their structure is often 
described as an inverted tree. At the top of this tree is the root directory, the source 
of the entire file system. It is designated by a / (slash). All other directories and files 
descend and branch out from root, as shown in Figure A-l. 



Figure A-l: Hierarchical structure of a file system 



One path from root leads to your home directory. You can organize and store infor- 
mation in your own hierarchy of directories and files under your home directory. 

Other paths lead from root to system directories that are available to all users. The 
system directories described in this book are common to all UMIPS system installa- 
tions and are provided and maintained by the operating system. 

In addition to this standard set of directories, your UMIPS system may have other 
system directories. To obtain a listing of the directories and files in the root directory 
on your UMIPS system, type the following command line: 



To move around in the file structure, you can use path names. For example, you can 
move to the directory /bin (which contains UMIPS system executable files) by typing 
the following command line: 



To list the contents of a directory, issue one of the following command lines: 



File System Structure 




Is -1 /<CR> 



cd /bin<CR> 



ls<CR> 
Is -1<CR> 



for a list of file and directory names 
for a detailed list of file and 
directory names 
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The U MIPS System Files 



To list the contents of a directory in which you are not located, issue the Is command 
as shown in the following examples: 

Is /bin<CR> for a short listing 
h ~1 /bin<CR> for a detailed listing 

The following section provides brief descriptions of the root directory and the system 
directories under it, as shown in Figure A4. 
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/ The source of the file system (called root directory) 

/bin Contains many executable programs and utilities, such as the follow- 

ing: 

cat 

date 

login 

grep 

mkdir 

who 

/lib Contains available program libraries and language libraries, such as 

libc.a system calls, standard I/O 

libm.a math routines and support for languages such as 
C, FORTRAN, and BASIC, 

/dev Contains special files that represent peripheral devices, such as: 

console console 
lp line printer 

tty/t user terminal(s) 

dsk/* disks 

/etc Contains programs and data files for system administration 

/tmp Contains temporary files, such as the buffers created for editing a file 

/usr Contains the following subdirectories which, in turn, contain the data 

listed below: 

news important news items 
mail electronic mail 

spool files waiting to be printed on the line 
printer 
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Basic UMIPS System Commands 



at Request that a command be run in background mode at a time you 

specify on the command line. If you do not specify a time, at(l) 
displays the job numbers of all jobs you have running in at(l), 
batch(l), or background mode. 

A sample format is: 



at 8s45am Jun 09<CR> 
commandl<CR> 
command2<CR> 
<Td> 



If you use the at command 
without the date, 

the command executes within twenty-four hours 
at the time specified. 

banner Display a message (in words up to ten characters long) in large letters 
on the standard output. 

batch Submit command(s) to be processed when the system load is at an 
acceptable level. A sample format of this command is: 

batch<CR> 

commandl<CE> 
command2<CR> 
<Td> 



You can use a shell script for a command in batch(l). 

This may be useful and timesaving if you have a set of commands 

you frequently submit using this command. 

cat Display the contents of a specified file at your terminal. To halt the 

output on an ASCII terminal temporarily, use <"s>; type <Tq> to 
restart the output. To interrupt the output and return to the shell on 
an ASCII terminal, press the BREAK or DELETE key. 

cd Change directory from the current one to your home directory. If you 

include a directory name, changes from the current directory to the 
directory specified. By using a path name in place of the directory 
name, you can jump several levels with one command. 

cp Copy a specified file into a new file, leaving the original file intact. 

cut Cut out specified fields from each line of a file. This command can be 

used to cut columns from a table, for example. 

date Display the current date and time. 

diff Compare two files. The diff(l) command reports which lines are 

different and what changes should be made to the second file to make 
it the same as the first file. 
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echo Display input on the standard output (the terminal), including the car- 
riage return, and returns a prompt, 

ed Edit a specified file using the line editor. If there is no file by the 

name specified, the ed(l) command creates one, See Chapter 5 for 
detailed instructions on using the ed(l) editor. 

grep Search a specified file(s) for a specified pattern and prints those lines 
that contain the pattern. If you name more than one file, grep(l) 
prints the file that contains the pattern, 

kill Terminate a background process specified by its process identification 

number (PID). You can obtain a PID by running the ps(l) command. 

lex Generate programs to be used in simple lexical analysis of text, 

perhaps as a first step in creating a compiler. See the User's Reference 
Manual for details. 

lp Print the contents of a specified file on a line printer, giving you a 

paper copy of the file. 

Ipstat Display the status of any requests made to the line printer. Options 
are available for requesting more detailed information. 

Is List the names of all files and directories except those whose names 

begin with a dot ( .). Options are available for listing more detailed 
information about the files in the directory. (See the ls(l) entry in the 
User's Reference Manual for details.) 

mail Display any electronic mail you may have received at your terminal, 
one message at a time. Each message ends with ? prompt; mail(l) 
waits for you to request an option such as saving, forwarding, or delet- 
ing a message. To obtain a list of the available options, type ?. 

When followed by a login name, mail(l) sends a message to the owner 
of that name. You can type as many lines of text as you want. Then 
type <*d> to end the message and send it to the recipient. Press the 
BREAK key to interrupt the mail sessipn. 

mailx mailx(l) is a more sophisticated, expanded version of electronic mail. 

make Maintain and support large programs or documents on the basis of 
smaller ones. See the make(l) page in the User's Reference Manual 
for details. 

mkdir Make a new directory. The new directory becomes a subdirectory of 
the directory in which you issue the mkdir command. To create sub- 
directories or files in the new directory, you must first move into the 
new directory with the cd command, 

mv Move a file to a new location in the file system. You can move a file 

to a new file name in the same directory or to a different directory. If 
you move a file to a different directory, you can use the same file 
name or choose a new one. 

nohup Place execution of a command in the background, so it will continue 
executing after you log off of the system. Error messages are placed 
in a file called nohup.out. 
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pg Display the contents of a specified file on your terminal, a page at a 

time. After each page, the system pauses and waits for your instruc- 
tions before proceeding. 

pr Display a partially formatted version of a specified file at your termi- 

nal. The pr(l) command shows page breaks, but does not implement 
any macros supplied for text formatter packages. 

ps Display the status and number of every process currently running. 

The ps(l) command does not show the status of jobs in the at(l) or 
batch(l) queues, but it includes these jobs when they are executing. 

pwd Display the full path name of the current working directory. 

rm Remove a file from the file system. You can use metacharacters with 

the rm(l) command but should use them with caution; a removed file 
cannot be recovered easily. 

rmdir Remove a directory. You cannot be in the directory you want to 
delete. Also, the command will not delete a directory unless it is 
empty. Therefore, you must remove any subdirectories and files that 
remain in a directory before running this command on it. (See rm -r 
in the User's Reference Manual for the ability to remove directories 
that are not empty.) 

sort Sort a file in ASCII order and displays the results on your terminal. 

ASCII order is as follows: 

1. numbers before letters 

2. upper case before lower case 

3. alphabetical order 

There are other options for sorting a file. For a complete list of 
sort(l) options, see the sort(l) page in the User's Reference Manual- 
spell Collect words from a specified file and check them against a spelling 
list. Words not on the list or not related to words on the list (with 
suffixes, prefixes, and so on) are displayed. 

stty Report the settings of certain input/output options for your terminal. 

When issued with the appropriate options and arguments, stty(l) also 
sets these input/output option. (See the stty(l) entry in the User's 
Reference Manual.) 

uname Display the name of the UMIPS system on which you are currently 
working. 

uucp Send a specified file to another UMIPS system. (See the uucp(l) page 
in the User's Reference Manual for details.) 

uuname List the names of remote UMIPS systems that can communicate with 
your UMIPS system. 

uupick Search the public directory for files sent to you by the uuto(l) com- 
mand. If a file is found, uupick(l) displays its name and the system it 
came from, and prompts you (with a ?) to take action. 

uustat Report the status of the uuto(l) command you issued to send files to 
another user. 
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unto Send a specified file to another user. Specify the destination in the 

format systemllogin i. The system must be on the list of systems gen- 
erated by the uuname(l) command. 

vi Edit a specified file using the vi(l) screen editor. If there is no file by 

the name you specify, vi(l) creates one. (See Chapter 6 for detailed 
information on using the vi(l) editor.) 

wc Count the number of lines, words, and characters in a specified file 

and display the results on your terminal, 

who Display the login names of the users currently logged in on your 

UMIPS system. List the terminal address for each login and the time 
each user logged in. 

yacc Impose a structure on the input of a program. See the User's Refer- 
ence Manual for details. 
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The general format for ed commands is: 

/ addressl,address2] command [parameter] . . , <CR> 

where addressl and address! denote line addresses and the parameters show the data 
on which the command operates. The commands appear on your terminal as you 
type them. You can find complete information on using ed commands in Chapter i5, 
"Line Editor Tutorial." 

The following is a glossary of ed commands. The commands are grouped according 
to function. 



Commands for Getting Started 

ed filename Accesses the ed line editor to edit a specified file, 
a Appends text after the current line. 

Ends the text input mode and returns to the command mode, 
p Displays the current line, 

d Deletes the current line. 

<CR> Moves down one line in the buffer. 
— Moves up one line in the buffer. 

w Writes the buffer contents to the file currently associated with the 

buffer. 

q Ends an editing session. If changes to the buffer were not written to a 

file, a warning (?) is issued. Typing q a second time ends the session 
without writing to a file, 



Line Addressing Commands 

1, 2, 3... Denotes line addresses in the buffer. 

Address of the current line in the buffer, 

.= Displays the current line address. 

$ Denotes the last line in the buffer. 

, Addresses the first through the last line. 

; Addresses the current line through the last line. 

+x Relative address, determined by adding x to the current line number. 

—x Relative address, determined by subtracting x from the current line 

number. 

labc Searches forward in the buffer and addresses the first line after the 

current line that contains the pattern abc. 
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labc Searches backward in the buffer and addresses the first line before the 

current line that contains the pattern abc. 

g/abc Addresses all lines in the buffer that contain the pattern abc. 

v/abc Addresses all lines in the buffer that do not contain the pattern abc. 

Display Commands 

p Displays the specified lines in the buffer. 

n Displays the specified lines preceded by their line addresses and a tab 
space. 

Text Input 

a Enters text after the specified line in the buffer. 

i Enters text before the specified line in the buffer. 

c Replaces text in the specified lines with new text. 

When typed on a line by itself, ends the text input mode and returns 
to the command mode. 

Deleting Text 

d Deletes one or more lines of text (command mode). 

u Undoes the last command given (command mode). 

@ Deletes the current line (in text input mode) or a command line (in 

command mode). 

# or BACKSPACE 

Deletes the last character entered as text (in input mode). 

Substituting Text 

address 1, address2$/old„text/new^text/ command 

Substitutes new-jext for old^text within the range of lines denoted by 
addre$sl,address2 (which may be numbers, symbols, or text). The 
command may be g, 1, n, p, or gp. 

Special Characters 

Matches any single character in search or substitution patterns. 

* Matches zero or more occurrences of the preceding character in 
search or substitution patterns. 

[...] Matches the first occurrence of a pattern in the brackets. 

[*...] Matches the first occurrence of a character that is not in the brackets. 

.* Matches zero or more occurrences of any characters following the 

period in search or substitution patterns. 
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The circumflex (") matches the beginning of the line in search or sub- 
stitution patterns. 

$ Matches the end of the line in search or substitution patterns. 

\ Takes away the special meaning of the special character that follows 

in search and substitution patterns. 

& Repeats the last pattern to be substituted. 

% Repeats the last replacement pattern. 

Text Movement Commands 

m Moves the specified lines of text after a destination line; deletes the 

lines at the old location. 

t Copies the specified lines of text and places the copied lines after a 

destination line. 

j Joins the current line with the next contiguous line. 

w Copies (writes) the buffer contents into a file. 

r Reads in text from another file and appends it to the buffer. 



Other Useful Commands and Information 

h Displays a short explanation for the preceding diagnostic response (?). 

H Turns on the help mode, which automatically displays an explanation 

for each diagnostic response (?) during the editing session. 

1 Displays nonprinting characters in the text. 

f Displays the current file name. 

f newfile Changes the current file name associated with the buffer to newfile. 

Icommand Allows you to escape, temporarily, to the shell to execute a shell com- 
mand. 

ed.hup If the terminal is hung up before a write command, the editing buffer 
is saved in the file ed.hup. 
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vi Quick Reference 



This appendix is a glossary of commands for the screen editor vi. The commands are 
grouped according to function, 

The general format of a vi command is: 

[x}[command}text-object 

where x denotes a number and text-object shows the portion of text on which the 
command operates. The commands appear on your screen as you type them. For an 
introduction to the use of vi commands, see Chapter 6, "Screen Editor Tutorial." 



Commands for Getting Started 



Shell Commands 

TERU^code 
export TERM 

tput ink 



Puts a code name for your terminal into the variable TERM. 

Conveys the value of TERM (the terminal code) to any UMIFS 
system program that is terminal dependent. 

Initializes the terminal so that it will function properly with 
various UMIPS system programs. 



NOTE 



Before you can use vi, you must complete the first three steps represented by the 
above three lines; setting the TERM variable, exporting the value of TERM, and run- 
ning the tput init command. 



vi filename Accesses the vi screen editor so that you can edit a specified 

file. 



Basic vi Commands 

<a> 
<ESC> 

<h> 

<j> 
<k> 
<i> 
<x> 
<CR> 

<ZZ> 

:w 



Enters text input mode and appends text after the cursor. 

Escape; leaves text input mode and returns to command 
mode. 

Moves the cursor to the left one character. 
Moves the cursor down one line in the same column. 
Moves the cursor up one line in the sartie column. 
Moves the cursor to the right one character. 
Deletes the current character. 

Carriage return; moves the cursor down to the beginning of 
the next line. 

Writes changes made to the buffer to the file and quits vi. 
Writes changes made to the buffer to the file. 
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Quits vi if changes made to the buffer have been written to a 
file. 



Commands for Positioning in the Window 

Positioning by Character 

<h> Moves the cursor one character to the left. 

<BACKSPACE> Backspace; moves the cursor one character to the left. 

<1> Moves the cursor one character to the right. 

< space bar> Moves the cursor one character to the right. 

<fx> Moves the cursor right to the specified character x. 

<¥x> Moves the cursor left to the specified character x. 

<tx> Moves the cursor right to the character just before the 

specified character x. 

<Tx> Moves the cursor left to the character just after the specified 

character x. 

<;> Continues the search for the character specified by the <f>, 

<F>, <t>, or <T> commands. The ; remembers the char- 
acter specified and searches for the next occurrence of it on 
the current line. 

< 9 > Continues the search for the character specified by the <f>, 

<F>, <t>, or <T> commands. The , remembers the char- 
acter specified and searches for the previous occurrence of it 
on the current line. 

Positioning by Line 

<j> Moves the cursor down one line from its present position, in 

the same column. 

<k> Moves the cursor up one line from its present position, in the 

same column. 

<+> Moves the cursor down to the beginning of the next line. 

<CR> Carriage return; moves the cursor down to the beginning of 

the next line. 

<-> Moves the cursor up to the beginning of the next line. 

Positioning by Word 

<w> Moves the cursor to the right, to the first character in the next 

word. 

<b> Moves the cursor back to the first character of the previous 

word. 
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<e> Moves the cursor to the end of the current word. 



Positioning by Sentence 

<(> Moves the cursor to the beginning of the sentence. 

<)> Moves the cursor to the beginning of the next sentence. 

Positioning by Paragraph 

<{> Moves the cursor to the beginning of the paragraph. 

<}> Moves the cursor to the beginning of the next paragraph. 

Positioning in the Window 

<H> Moves the cursor to the first line on the screen, or "home." 

<M> Moves the cursor to the middle line on the screen. 

<L> Moves the cursor to the last line on the screen. 

Commands for Positioning in the File 

Scrolling 

<"f> Scrolls the screen forward a full window, revealing the window 

of text below the current window. 

<"d> Scrolls the screen down a half window, revealing lines of text 

below the current window. 

<"b> Scrolls the screen back a full window, revealing the window of 

text above the current window. 

<"u> Scrolls the screen up a half window, revealing the lines of text 

above the current window. 

Positioning on a Numbered Line 

<G> Moves the cursor to the beginning of the last line in the buffer. 

<nG> Moves the cursor to the beginning of the nth line of the file (n 

= line number). 

Searching for a Pattern 

/pattern Searchs forward in the buffer for the next occurrence of the 

pattern of text. Positions the cursor under the first character 
of the pattern. 

^pattern Searches backward in the buffer for the first occurrence of 

pattern of text. Positions the cursor under the first character 
of the pattern. 
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<n> 
<N> 



Repeats the last search command. 

Repeats the search command in the opposite direction. 



Commands for Inserting Text 

<a> Enters text input mode and appends text after the cursor. 

<i> Enters text input mode and inserts text before the cursor. 

<o> Enters text input mode by opening a new line immediately 

below the current line. 

<0> Enters text input mode by opening a new line immediately 

above the current line. 

<ESC> Escape; returns to command mode from text input mode 

(entered with any of the above commands). 



Commands for Deleting Text 

In Text Input Mode 

<BACKSPACE> Backspace; deletes the current character. 
<"w> Deletes the current word delimited by blanks. 

<@> Erases the current line of text. 



In Command Mode 



<x> Deletes the current character. 

<dw> Deletes a word (or part of a word) from the cursor through 

the next space or to the next punctuation. 

<dd> Deletes the current line. 

<ndx> Deletes n number of text objects of type x, where x may be as 

a word, line, sentence, or paragraph. 

<D> Deletes the current line from the cursor to the end of the line. 



Commands for Modifying Text 

Characters, Words, Text Objects 

<r> Replaces the current character. 

<s> Deletes the current character and appends text until the 

<ESC> command is typed. 
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<S> 
<~> 
<cw> 

<cc> 

<ncx> 

<C> 



Replaces all the characters in the current line. 

Changes upper case to lower case or lower case to upper case. 

Replaces the current word or the remaining characters in the 
current word with new text, from the cursor to the next space 
or punctuation. 

Replaces all the characters in the current line. 

Replaces n number of text objects of type x, where x may be a 
word, line, sentence, or paragraph. 

Replaces the remaining characters in the currejit line, from 
the cursor to the end of the line. 



Cutting and Pasting Text 
<P> 



<yy> 

<nyx> 
<"lyx> 
<"xp> 



Places the contents of the temporary buffer (containing the 
output of the last delete or yank command) into the text after 
the cursor or below the current line. 

Yanks (extracts) a specified line of text and puts it into a tem- 
porary buffer. 

Extracts a copy of n number of text objects of type x and puts 
it into a temporary buffer. 

Places a copy of text object x into a register named by a letter 
/. x may be a word, line, sentence, or paragraph. 

Places the contents of register x after the cursor or below the 
current line. 



Other Commands 
Special Commands 





Gives the line number of current cursor position in the buffer 




and modification status of the file. 


<•> 


Repeats the action performed by the last command. 


<u> 


Undoes the effects of the last command, 


<U> 


Restores the current line to its state prior to present changes. 


<J> 


Joins the line immediately below the current line with the 




current line. 


<ri> 


Clears and redraws the current window. 



Line Editor Commands 

: Tells vi that the next commands you issue will be line editor 

commands. 
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:sh 

<Td> 

in 

:x, zw filename 
$ 

.,$d 

r filename 
:s/text/new^text/ 



Temporarily returns to the shell to perform some shell com- 
mands without leaving vi. 

Escapes the temporary return to the shell and returns to vi so 
you can edit the current window. 

Goes to the nth line of the buffer. 

Writes lines from the number x through the number z into a 
new file called filename. 

Moves the cursor to the beginning of the last line in the buffer. 

Deletes all the lines from the current line to the last line. 

Inserts the contents of the file filename under the current line 
of the buffer. 



: $/text/new„text/g 



Replaces the first instance of text on the current line with 
newjtext. 

Replace every occurrence of text on the current line with 
new_text. 

:g/text/$//new_text/g 

Changes every occurrence of text in the buffer to new_text. 



Commands for Quitting vi 



<zz> 

:wq 

:w filename 
tq 

:w! filename 

•q 



.q. 



Writes the buffer to the file and quits vi. 
Writes the buffer to the file and quits vi. 

Writes the buffer to the new file filename and quits vi. 

Overwrites the existing file filename with the contents of the 
buffer and quits vi. 

Quits vi whether or not changes made to the buffer were writ- 
ten to a file. Does not incorporate changes made to the buffer 
since the last write (:w) command. 

Quits vi if changes made to the buffer were written to a file. 



Special Options for vi 

vi filel file2 fileS 

Enters three files into the vi buffer to be edited. Those files 
are filel, filel, and file3. 

:w 

:n When more than one file has been called on a single vi com- 

mand line, writes the buffer to the file you are editing and then 
calls the next file in the buffer (use :n only after :w). 
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vi -r filel Restores the changes made to filel that were lost because of 

an interrupt in the system. 

view filel Displays filel in the read-only mode of vi. Any changes made 

to the buffer will not be allowed to be written to the file, 
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Summary of Shell Command Language 



This appendix is a summary of the shell command language and programming con- 
structs discussed in Chapter 7, "Shell Tutorial." The first section reviews metacharac- 
ters, special characters, input and output redirection, variables and processes. These 
are arranged by topic in the order that they were discussed in the chapter. The 
second section contains models of the shell programming constructs. 



The Vocabulary of Shell Command Language 



Special Characters in the Shell 

* ? [ ] . Metacharacters; used to provide a shortcut to referencing file names, 
through pattern matching. 

& Executes commands in the background mode. 

; Sequentially executes several commands typed on one line, each pair 

separated by ;. 

\ Turns off the meaning of the immediately following special character. 

Enclosing single quotes turn off the special meaning of all characters. 

Enclosing double quotes turn off the special meaning of all characters 
except $ and 

Redirecting Input and Output 

< Redirects the contents of a file into a command. 

> Redirects the output of a command into a new file, or replaces the 

contents of an existing file with the output. 

>> Redirects the output of a command so that it is appended to the end 

of a file. 

| Directs the output of one command so that it becomes the input of 

the next command. 

s command Substitutes the output of the enclosed command in place oV com- 
mand. 

Executing and Terminating Processes 



batch Submits the following commands to be processed at a time when the 
system load is at an acceptable level. <"d> ends the batch command. 

at Submits the following commands to be executed at a specified time. 

<"d> ends the at command. 

at —1 Reports which jobs are currently in the at or batch queue. 

at — r Removes the at or batch job from the queue. 
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ps Reports the status of the shell processes. 

kill PID Terminates the shell process with the specified process ID (PID). 

no hup command list & 

Continues background processes after logging off. 

Making a File Accessible to the Shell 

chmod u+x filename 

Gives the user permission to execute the file (useful for shell program 
files). 

mv filename $HOME/bin/filename 

Moves your file to the bin directory in your home directory. This bin 
holds executable shell programs that you want to be accessible. Make 
sure the PATH variable in your .profile file specifies this bin. If it 
does, the shell will search in $HOME/bin for your file when you try to 
execute it. If your PATH variable does not include your bin, the shell 
will not know where to find your file and your attempt to execute it 
will fail. 

filename The name of a file that contains a shell program becomes the com- 
mand that you type to run that shell program. 

Variables 

positional parameter 

A numbered variable used within a shell program to reference 
values automatically assigned by the shell from the arguments of 
the command line invoking the shell program. 

echo A command used to print the value of a variable on your terminal. 

$# A special parameter that contains the number of arguments with 

which the shell program has been executed. 

$* A special parameter that contains the values of all arguments with 

which the shell program has been executed. 

named variable 

A variable to which the user can give a name and assign values. 
Variables Used in the System 



HOME Denotes your home directory; the default variable for the cd com- 
mand. 

PATH Defines the path your login shell follows to find commands. 

CDPATH Defines the search path for the cd command. 

MAIL Gives the name of the file containing your electronic mail. 

PS1 PS2 Define the primary and secondary prompt strings. 

TERM Defines the type of terminal. 
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LOGNAME Login name of the user. 

IFS Defines the internal field separators (normally the space, the tab, 

and the carriage return). 

TERMINFO Allows you to request that the curses and terminfo subroutines 

search a specified directory tree before searching the default direc- 
tory for your terminal type. 

TZ Sets and maintains the local time zone. 



Shell Programming Constructs 

Her$ Document 



command <<! 

input lines 
t 



For (Lpop 



for variable<CR> 

in this list of values<CR> 
do the following commands<CR> 

command 1<CR> 

command 2<CR> 



last command<CR> 
done<CR> 



SUMMARY OF SHELL COMMAND LANGUAGE E-3 



Summary of Shell Command Language 
While Loop 



while command list <CR> 

do<CR> 

command I<CR> 
command 2<CR> 



last command<CR> 
done<CR> 



If ...Then 



if this command is sucessful<CR> 
then command 2<CR> 
command2<CB> 



last command<CJl> 

fl<CR> 



lf...Then...Else 



if command list<CH> 

then command list<CR> 
else command list<CR> 

fl<CR> 
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Case Construction 



case word<CR> 




in<CR> 




patternl)<CR> 
command line 


i<CR> 


last command 


line<CR> 


;;<CR> 




pattern2) <CR> 
command line 


2<CR> 


last command 




;;<CR> 




pattern3)<CR> 
command line 


i<CR> 


last command 


line<CR> 


;;<CR> 




esac<CR> 





break and continue Statements 

A break or continue statement forces the program to leave any loop and execute the 
command following the end of the loop. 



SUMMARY OF SHELL COMMAND LANGUAGE E-5 



( 



Setting the TERM Variable 



MIPS supports many types of terminals for use with the UMIPS system. Because 
some commands are terminal dependent, the system must know what type of terminal 
you are using whenever you log in. The system determines the characteristics of your 
terminal by checking the value of a variable called TERM which holds the name of a 
terminal. If you have put the name of your terminal into this variable, the system will 
be able to execute all programs in a way that is suitable for your terminal. 

This method of telling the UMIPS system what type of terminal you are using is called 
setting the terminal configuration. To set your terminal configuration, type the com- 
mand lines shown on the following screen, substituting the name of your terminal for 
terminal jname. 



$ TERM=terminaLname<CR> 
$ export TERM<CR> 
$ tput init<CR> 




These lines must be executed in the order shown; otherwise, they will not work. 
Also, this procedure must be repeated every time you log in. Therefore, most users 
put these lines into a file called .profile that is automatically executed every time they 
log in. For details about the .profile file, see Chapter 7. 

The first two lines in the screen tell the UMIPS system shell what type of terminal you 
are using. The tput init command line instructs your terminal to behave in ways that 
the UMIPS system expects a terminal of that type to behave. For example, it sets the 
terminal's left margin and tabs, if those capabilities exist for the terminal. 

The tput command uses the entry in this database for your terminal to make terminal 
dependent capabilities and information available to the shell. Because the values of 
these capabilities differ for each type of terminal, you must execute the tput init com- 
mand line every time you change the TERM variable. 

For each terminal type, a set of capabilities is defined in a database. This database is 
usually found in the /usr/lib/terminfo directory. 

The following sections describe how you can determine what terminaljnames are 
acceptable. Further information about the capabilities in the terminfo database can 
be found on the terminfo (4) manual page in the Programmer's Reference Manual. 
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Acceptable Terminal Names 

The UMIPS system recognizes a wide range of terminal types. Before you put a ter- 
minal name into the TERM variable, you must make sure that your terminal is within 
that range, 

You must also verify that the name you put into the TERM variable is a recognized 
terminal name. There are usually at least two recognized names: the name of the 
manufacturer and the model number, However, there are several ways to represent 
these names; by varying the use of uppercase and lowercase, using abbreviations, and 
so on. Do not put a terminal name in the TERM variable until you have verified that 
the system recognizes it. 

The tput command provides a quick way to make sure your terminal is supported by 
your system. Type: 

tput -*Tterminal Lname longname<CR> 

If your system supports your terminal it will respond with the complete name of your 
terminal. Otherwise, you will get an error message. 

To find an acceptable name that you can put in the TERM variable, find a listing for 
your terminal in the directory /usr/lib/terminfo. Each of these directories is a collec- 
tion of files with single-character names. Each file, in turn, holds a list of terminal 
names that all begin with the name of the file. (This name can be either a letter, such 
as the initial A in AT&T, or a number, such as the initial 5 in 5425.) Find the file 
whose iiame matches the first character of your terminal's name. Then list the file's 
contents and look for your terminal, 

You can also check with your system administrator for a list of terminals supported 
by your system, and the acceptable names you can put in the TERM variable. 
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Suppose your terminal is an AT&T Teletype Model 5425. Your login is jim and you 
are currently in your home directory. First, you verify that your system supports your 
terminal by running the tput command. Next, you find an acceptable name for it in 
the /usr/lib/terminfo/A directory. The following screen shows which commands you 
need to do this: 



$ tput -T5425 longname<CR> 

AT&T 4425/5425 

$ cd /usr/lib/terminfo/A<CR> 
$ Is 

ATT4410 

ATT4415 

ATT4418 

ATT4424 

ATT4424-2 

ATT4425 

ATT4426 

ATT513 

ATT5410 

ATT5418 

ATT5420 

ATT5420-2 

ATT5425 

ATT5620 

ATT610BCT 

ATTPT505 

$ 



Now you are ready to put the name you found, ATT5425, in the TERM variable. 
Whenever you do this, you must also export TERM and execute tput init. 



$ TERM=ATT5425<CR> 
$ export TERM<CR> 
$ tput init<CR> 

$ 



The UMIPS system now knows what type of terminal you are using and will execute 
commands appropriately. 
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Glossary 



acoustic coupler 

A device that permits transmission of data over an ordinary telephone line. 
When you place a telephone handset in the coupler, you link a computer at 
one end of the phone line to a peripheral device, such as a user terminal, at 
the other. 

address 

Generally, a number that indicates the location of information in the 
computer's memory. In the UMIPS system, the address is part of an editor 
command that specifies a line number or range. 

append mode 

A text editing mode in which the characters you type are entered as text into 
the text editor's buffer. In this mode you enter (append) text after the 
current position in the buffer. See text input mode, compare with command 
mode and insert mode. 

argument 

The element of a command line that specifies data on which a command is 
to operate. Arguments follow the command name and can include 
numbers, letters, or text strings. For instance, in the command 
Ip -m myfile, Ip is the command and myfile is the argument. See option. 

ASCII 

(pronounced as'-kee) American Standard Code for Information Inter- . 
change, a standard for data transmission that is used in the UMIPS system. 
ASCII assigns sets of Os and Is to represent 128 characters, including alpha- 
betical characters, numerals, and standard special characters, such as #, $, 
%,and&. 

background 

A type of program execution where you request the shell to run a command 
away from the interaction between you and the computer ("in the back- 
ground"). While this command runs, the shell prompts you to enter other 
commands through the terminal. 

baud rate 

A measure of the speed of data transfer from a computer to a peripheral 
device (such as a terminal) or from one device to another. Common baud 
rates are 300, 1200, 4800, and 9600. As a general guide, divide a baud rate 
by 10 to get the approximate number of English characters transmitted each 
second. 

buffer 

A temporary storage area of the computer used by text editors to make 
changes to a copy of an existing file. When you edit a file, its contents are 
read into a buffer, where you make changes to the text. For the changes to 
become a part of the permanent file, you must write the buffer contents 
back into the file. See permanent file. 

child directory 

See subdirectory. 

command 

The name of a file that contains a program that can be executed by the com- 
puter on request. Compiled programs and shell programs are forms of 
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commands. 

command file 

See executable file. 

command language interpreter 

A program that acts as a direct interface between you and the computer. In 
the UMIPS system, a program called the shell takes commands and 
translates them into a language understood by the computer. 

command line 

A line containing one or more commands, ended by typing a carriage return 
(<CR>). The line may also contain options and arguments for the com- 
mands. You type a command line to the shell to instruct the computer to 
perform one or more tasks. 

command mode 

A text editing mode in which the characters you type are interpreted as edit- 
ing commands. This mode permits actions such as moving around in the 
buffer, deleting text, or moving lines of text. See text input mode, compare 
with append mode and insert mode. 

context search 

A technique for locating a specified pattern of characters (called a string) 
when in a text editor. Editing commands that cause a context search scan 
the buffer, looking for a match with the string specified in the command. 
See string. 

control character 

A nonprinting character that is entered by holding down the control key and 
typing a character. Control characters are often used for special purposes. 
For instance, when viewing a long file on your screen with the cat command, 
typing control-s ("s) stops the display so you can read it, and typing control- 
q ("q) continues the display. 

current directory 

The directory in which you are presently working. You have direct access to 
all files and subdirectories contained in your current directory. The short- 
hand notation for the current directory is a dot (.). 

cursor 

A cue printed on the terminal screen that indicates the position at which you 
enter or delete a character. It is usually a rectangle or a blinking underscore 
character. 

default 

An automatically assigned value or condition that exists unless you explicitly 
change it. For example, the shell prompt string has a default value of $ 
unless you change it. 

delimiter 

A character that logically separates words or arguments on a command line. 
Two frequently used delimiters in the UMIPS system are the space and the 
tab. 

diagnostic 

A message printed at your terminal to indicate an error encountered while 
trying to execute some command or program. Generally, you need not 
respond directly to a diagnostic message. 
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directory 

A type of file used to group and organize other files or directories. You can- 
not directly enter text or other data into a directory, (For more detail, see 
Appendix A, Summary of the File System.) 

disk 

A magnetic data storage device consisting of several round plates similar to 
phonograph records. Disks store large amounts of data and allow quick 
access to any piece of data. 

electronic mail 

The feature of an operating system that allows computer users to exchange 
written messages via the computer. The UMIPS system mail command pro- 
vides electronic mail in which the addresses are the login names of users. 

environment 

The conditions under which you work while using the UMIPS system. Your 
environment includes those things that personalize your login and allow you 
to interact in specific ways with the UMIPS system and the computer. For 
example, your shell environment includes such things as your shell prompt 
string, specifics for backspace and erase characters, and commands for 
sending output from your terminal to the computer, 

erase character 

The character you type to delete the previous character you typed. The 
UMIPS system default erase character is #; some users set the erase charac- 
ter to the BACKSPACE key. 

escape 

A means of getting into the shell from within a text editor or other program, 
execute 

The computer's action of running a program or command and performing 
the indicated operations. 

executable file 

A file that can be processed or executed by the computer without any 
further translation. When you type in the file name, the commands in the 
file are executed. See shell procedure. 

file 

A collection of information in the form of a stream of characters. Files may 
contain data, programs, or other text. You access UMIPS system files by 
name. See ordinary file, permanent file, and executable file. 

file name 

A sequence of characters that denotes a file. (In the UMIPS system, a slash 
character (/) cannot be used as part of a file name.) 

file system 

A collection of files and the structure that links them together. The UMIPS 
file system is a hierarchical structure. (For more detail, see Appendix A, 
Summary of the File System.) 
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filter 

A command that reads the standard input, acts on it in some way, and then 
prints the result as standard output. 

final copy 

The completed, printed version of a file of text, 
foreground 

The normal type of command execution. When executing a command in 
foreground, the shell waits for one command to end before prompting you 
for another command. In other words, you enter something into the com- 
puter and the computer "replies" before you enter something else. 

full-duplex 

A type of data communication in which a computer system can transmit and 
receive data simultaneously. Terminals and modems usually have settings 
for half-duplex (one-way) and full-duplex communication; the UMIPS system 
uses the full-duplex setting. 

full path name 

A path name that originates at the root directory of the UMIPS system and 
leads to a specific file or directory. Each file and directory in the UMIPS 
system has a unique full path name, sometimes called an absolute path 
name. See path name. 

global 

A term that indicates the complete or entire file. While normal editor com- 
mands commonly act on only the first instance of a pattern in the file, global 
commands can perform the action on all instances in the file. 

hardware 

The physical machinery of a computer and any associated devices, 
hidden character 

One of a group of characters within the standard ASCII character set that 
are not printable. Characters such as backspace, escape, and < A d> are 
examples. 

home directory 

The directory in which you are located when you log in to the UMIPS sys- 
tem; also known as your login directory. 

input/output 

The path by which information enters a computer system (input) and leaves 
the system (output). An input device that you use is the terminal keyboard 
and an output device is the terminal display. 

insert mode 

A text editing mode in which the characters you type are entered as text into 
the text editor's buffer. In this mode you enter (insert) text before the 
current position in the buffer. See text input mode, compare with append 
mode and command mode. 

interactive 

Describes an operating system (such as the UMIPS system) that can handle 
immediate-response communication between you and the computer. In 
other words, you interact with the computer from moment to moment. 
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line editor 

An editing program in which text is operated upon on a line-by-line basis 
within a file. Commands for creating, changing, and removing text use line 
addresses to determine where in the file the changes are made. Changes can 
be viewed after they are made by displaying the lines changed. See text edi- 
tor, compare with screen editor. 

login 

The procedure used to gain access to the UMIPS operating system. 

login directory 

See home directory. 

login name 

A string of characters used to identify a user. Your login name is different 
from other login names. 

log off 

The procedure used to exit from the UMIPS operating system, 
metacharacter 

A subset of the set of special characters that have special meaning to the 
shell. The metacharacters are *, ?, and the pair [ ]. Metacharacters are 
used in patterns to match file names, 

mode 

In general, a particular type of operation (for example, an editor's append 
mode). In relation to the file system, a mode is an octal number used to 
determine who can have access to your files and what kind of access they 4 
can have. See permissions. 

modem 

A device that connects a terminal and a computer by way of a telephone 
line. A modem converts digital signals to tones and converts tones back to 
digital signals, allowing a terminal and a computer to exchange data over 
standard telephone lines. 

multitasking 

The ability of an operating system to execute more than one program at a 
time. 

multiuser 

The ability of an operating system to support several users on the system at 
the same time. 

nroff 

A text formatter available as an add-on to the UMIPS system. You can use 
the nroff program to produce a formatted on-line copy or a printed copy of 
a file. See text formatter. 

operating system 

The software system on a computer under which all other software runs. 
The UMIPS system is an operating system. 

option 

Special instructions that modify how a command runs. Options are a type 
of argument that follow a command and usually precede other arguments on 
the command line. By convention, an option is preceded by a minus sign 
(-); this distinguishes it from other arguments. You can specify more than 
one option for some commands given in the UMIPS system. For example, 
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in the command Is -1 -a directory, -1 and -a are options that modify the 
Is command. See argument. 

ordinary file 

A file, containing text or data, that is not executable. See executable file, 
output 

Information processed in some fashion by a computer and delivered to you 
by way of a printer, a terminal, or a similar device. 

parameter 

A special type of variable used within shell programs to access values 
related to the arguments on the command line or the environment in which 
the program is executed. See positional parameter. 

parent directory 

The directory immediately above a subdirectory or file in the file system 
organization. The shorthand notation for the parent directory is two dots 

go. 

parity 

A method used by a computer for checking that the data received matches 
the data sent. 

password 

A code word known only to you that is called for in the login process. The 
computer uses the password to verify that you may indeed use the system. 

path name 

A sequence of directory names separated by the slash character (/) and end- 
ing with the name of a file or directory. The path name defines the connec- 
tion path between some directory and the named file. 

peripheral device 

Auxiliary devices under the control of the main computer, used mostly for 
input, output, and storage functions. Some examples include terminals, 
printers, and disk drives. 

permanent file 

The data stored permanently in the file system structure. To change a per- 
manent file, you can make use of a text editor, which maintains a temporary 
work space, or buffer, apart from the permanent files. Once changes have 
been made to the buffer, they must be written to the permanent file to make 
the changes permanent. See buffer. 

permissions 

Access modes, associated with directories and files, that permit or deny sys- 
tem users the ability to read, write, and/or execute the directories and files. 
You determine the permissions for your directories and files by changing the 
mode for each one with the chmod command. 

pipe 

A method of redirecting the output of one command to be the input of 
another command. It is named for the character | that redirects the output. 
For example, the shell command who | wc -1 pipes output from the who 
command to the wc command, telling you the total number of people logged 
into your UMIPS system. 
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pipeline 

A series of filters separated by | (the pipe character). The output of each 
filter becomes the input of the next filter in the line. The last filter in the 
pipeline writes to its standard output, or may be redirected to a file. See 
filter. 

positional parameters 

Numbered variables used within a shell procedure to access the strings 
specified as arguments on the command line invoking the shell procedure. 
The name of the shell procedure is positional parameter $0. See variable 
and shell procedure. 

prompt 

A cue displayed at your terminal by the shell, telling you that the shell is 
ready to accept your next request. The prompt can be a character or a 
series of characters. The UMIPS system default prompt is the dollar sign 
character ($). 

printer 

An output device that prints the data it receives from the computer on 
paper. 

process 

Generally a program that is at some stage of execution. In the UMIPS sys- 
tem, it also refers to the execution of a computer environment, including 
contents of memory, register values, name of the current directory, status of 
files, information recorded at login time, and various other items. 

program 

The instructions given to a computer on how to do a specific task. Pro- 
grams are user-executable software. 

read-ahead capability 

The ability of the UMIPS system to read and interpret your input while 
sending output information to your terminal in response to. previous input. 
The UMIPS system separates input from output and processes each 
correctly. 

relative path name 

The path name to a file or directory which varies in relation to the directory 
in which you are currently working. 

remote system 

A system other than the one on which you are working. 

root 

The source directory of all files and directories in the file system; designated 
by the slash character (/). 

screen editor 

An editing program in which text is operated on relative to the position of 
the cursor on a visual display. Commands for entering, changing, and 
removing text involve moving the cursor to the area to be altered and per- 
forming the necessary operation. Changes are viewed on the terminal 
display as they are made. See text editor, compare with line editor. 

search pattern 
See string. 
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search string 
See string. 

secondary prompt 

A cue displayed at your terminal by the shell to tell you that the command 
typed in response to the primary prompt is incomplete. The UMIPS system 
default secondary prompt is the "greater than" character (>). 

shell 

A UMIPS system program that handles the communication between you and 
the computer. The shell is also known as a command language interpreter 
because it translates your commands into a language understandable by the 
computer. The shell accepts commands and causes the appropriate program 
to be executed. 

shell procedure 

An executable file that is not a compiled program. A shell procedure calls 
the shell to read and execute commands contained in a file. This lets you 
store a sequence of commands in a file for repeated use. It is also called a 
shell program or command file. See executable file. 

silent character 

See hidden character. 

software 

Instructions and programs that tell the computer what to do. Contrast with 
hardware. 

source code 

The uncompiled version of a program written in a language such as C or 
Pascal. The source code must be translated to machine language by a pro- 
gram known as a compiler before the computer can execute the program. 

special character 

A character having special meaning to the shell program and used for com- 
mon shell functions such as file redirection, piping, background execution, 
and file name expansion. The special characters include <, >, |, ;, &, *, ?, 
[, and ]. 

special file 

A file (called a device driver) used as an interface to an input/output device, 
such as a user terminal, a disk drive, or a line printer. 

standard input 

An open file that is normally connected directly to the keyboard. Standard 
input to a command normally goes from the keyboard to this file and then 
into the shell. You can redirect the standard input to come from another 
file instead of from the keyboard; use an argument in the form < file. Input 
to the command will then come from the specified file. 

standard output 

An open file that is normally connected directly to a primary output device, 
such as a terminal printer or screen. Standard output from the computer 
normally goes to this file and then to the output device. You can redirect 
the standard output into another file instead of to the printer or screen; use 
an argument in the form > file. Output will then go to the specified file. 
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string 

Designation for a particular group or pattern of characters, such as a word 
or phrase, that may contain special characters. In a text editor, a context 
search interprets the special characters and attempts to match the specified 
pattern with a string in the editor buffer. 

string variable 

A sequence of characters that can be the value of a shell variable. See vari- 
able. 

subdirectory 

A directory pointed to by a directory one level above it in the file system 
organization; also called a child directory. 

system administrator 

The person who monitors and controls the computer on which your UMIPS 
system runs; sometimes referred to as a super-user. 

terminal 

An input/output device connected to a computer system, usually consisting 
of a keyboard with a video display or a printer. A terminal allows you to 
give the computer instructions and to receive information in response. 

text editor 

Software for creating, changing, or removing text with the aid of a com- 
puter. Most text editors have two modes-an input mode for typing in text 
and a command mode for moving or modifying text. Two examples are the 
UMIPS system editors ed and vi. See line editor and screen editor. 

text formatter 

A program that prepares a file of text for printed output. To make use of a 
text formatter, your file must also contain some special commands for struc- 
turing the final copy. These special commands tell the formatter to justify 
margins, start new paragraphs, set up lists and tables, place figures, and so 
on. Two text formatters available as add-ons to your UMIPS system are 
nroff and troff. 

text input mode 

A text editing mode in which the characters you type are entered as text into 
the text editor's buffer. To execute a command, you must leave text input 
mode. See command mode, compare with append mode and insert mode. 

timesharing 

A method of operation in which several users share a common computer 
system seemingly simultaneously. The computer interacts with each user in 
sequence, but the high-speed operation makes it seem that the computer is 
giving each user its complete attention. 

tool 

A package of software programs. 

troff 

A text formatter available as an add-on to the UMIPS system. The troff 
program drives a phototypesetter to produce high-quality printed text from a 
file. See text formatter. 

tty 

Historically, the abbreviation for a teletype terminal. Today, it is generally 
used to denote a user terminal. 
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user 

Anyone who uses a computer or an operating system. 

user-defined 

Something determined by the user. 

user-defined variable 

A named variable given a value by the user. See variable. 

UMIPS 

An operating system that incorporates the functionality of UNIX (see 
below) plus that of other UNIX-dervied operating systems. 

UNIX system 

A general-purpose, multiuser, interactive, time-sharing operating system 
developed by AT&T Bell Laboratories. The UMIPS system allows limited 
computer resources to be shared by several users and efficiently organizes 
the user's interface to a computer system. 

utility 

Software used to carry out routine functions or to assist a programmer or 
system user in establishing routine tasks. 

variable 

A symbol whose value may change. In the shell, a variable is a symbol 
representing some string of characters (a string value). Variables may be 
used in an interactive shell as well as within a shell procedure. Within a 
shell procedure, positional parameters and keyword parameters are two 
forms of variables. (Keyword parameters are discussed fully in "Shell Com- 
mands and Programming".) 

video display terminal 

A terminal that uses a television-like screen (a monitor) to display informa- 
tion, A video display terminal can display information much faster than 
printing terminals. 

visual editor 

See screen editor. 

working directory 

See current directory. 
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